Getting Started

1. Get credentials

You authenticate with either an API key or an OAuth2 client. Both are created in the LedgerBee app under Marketplace — the API Keys and OAuth Clients tabs. See Authentication for the trade-offs.

2. Make your first call

With an API key:

Code
curl https://api.ledgerbee.com/api/v1/company \
  -H "x-api-key: YOUR_API_KEY"

With an OAuth2 bearer token:

Code
curl https://api.ledgerbee.com/api/v1/company \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

3. Explore interactively

Open the API Reference and use the Try it console — paste your key or token once and call any endpoint directly from the browser.

Conventions

• Pagination: page through large lists with the cursor each response returns as nextCursor. Paging by page number is deprecated, and from 2026-12-31 is limited to lists of up to 10,000 rows; see Pagination. Response shapes are documented per endpoint in the API Reference.
• Idempotency: usage reporting and checkout confirmation require an x-api-idempotency-key header; other mutating endpoints accept it as an optional header for safe retries, except the OAuth, SCIM, MCP and portal SSO protocol endpoints — see Idempotency.
• Errors: failures return a JSON body with a stable code plus details.