Quick Start

All API v1 endpoints are served from the following base URL:

https://www.react-accounting.com/api/v1

Authentication endpoints use a separate base path:

https://www.react-accounting.com/api/auth

React Accounting supports two authentication methods:

Session (cookies)

Cookie-based session authentication powered by Better Auth:

1. Sign in via POST /api/auth/sign-in/email with your email and password.
2. The response sets a session cookie automatically.
3. Include the cookie in all subsequent requests.

curl -X POST https://www.react-accounting.com/api/auth/sign-in/email \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}' \
  -c cookies.txt

# Use the session cookie for API requests
curl https://www.react-accounting.com/api/v1/dashboard \
  -b cookies.txt

API keys (organization-scoped)

For programmatic access, use organization-scoped API keys. Create and manage keys in Organization Settings → API Keys. Send the key via the x-api-key header or Authorization: Bearer.

curl https://www.react-accounting.com/api/v1/dashboard \
  -H "x-api-key: ra_your_api_key_here"

Most API endpoints require an active organization. After signing in, set the active organization using the Better Auth organization endpoint. All subsequent API calls will operate within that organization's context.

All responses are JSON. Dates are ISO 8601 strings and monetary values are numbers.

{
  "id": "clu1abc2d0001...",
  "amount": 1250.00,
  "currency": "EUR",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

Both APIs expose OpenAPI specifications that you can use to generate a type-safe client SDK in any language using tools like openapi-generator, swagger-codegen, or any OpenAPI-compatible code generator.

# Example: generate a Swift client
bunx @openapitools/openapi-generator-cli generate \
  -i https://www.react-accounting.com/api/v1/openapi/json \
  -g swift5 \
  -o ./generated/swift-client

# Example: generate a Kotlin client
bunx @openapitools/openapi-generator-cli generate \
  -i https://www.react-accounting.com/api/v1/openapi/json \
  -g kotlin \
  -o ./generated/kotlin-client