> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlemma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The Lemma API allows platforms to programmatically interact with entity's accounts and reconciliation data.

<Note>
  The Lemma API is only available to approved platforms. To request access,
  reach out to the Lemma team at
  [contact@getlemma.com](mailto:contact@getlemma.com).
</Note>

The Lemma API is a REST API that returns JSON responses. It gives you read access to your bank accounts and transaction history so you can build integrations with your practice management software, accounting tools, or internal systems.

## Base URL

All API requests are made to:

```
https://api.getlemma.com/v0
```

## Request format

All requests must include an `Authorization` header with your API key. See [Authentication](/api-reference/authentication) for details.

For endpoints that accept a request body (POST, PUT, PATCH), you must set the `Content-Type` header to `application/json`. Requests with a body that are missing this header will receive a `415 Unsupported Media Type` response.

```bash theme={null}
curl https://api.getlemma.com/v0/accounts \
  -H "Authorization: Bearer lm_key_your_api_key" \
  -H "Content-Type: application/json"
```

## Response format

All responses are returned as `application/json`.

List endpoints return a `data` array along with `meta` and `links` objects for [pagination](/api-reference/pagination). Single-resource endpoints return a JSON object directly.

## Errors

The API returns standard HTTP status codes. Error responses include a `message` field.

```json Example error message theme={null}
{
  "message": "Account not found",
  "error": "Not found",
  "status": 404
}
```

| Status | Meaning                                                       |
| ------ | ------------------------------------------------------------- |
| 200    | Success                                                       |
| 400    | Bad request — check your parameters                           |
| 401    | Unauthorized — invalid or missing API key                     |
| 404    | Not found — the resource does not exist                       |
| 415    | Unsupported media type — set `Content-Type: application/json` |
| 429    | Too many requests — slow down and retry                       |
| 500    | Server error — try again later                                |

## Rate limits

The API allows up to **500 requests per minute** per API key. If you exceed this limit, you'll receive a `429` response. Wait and retry after a brief pause.

Need higher limits? [Contact us](mailto:contact@getlemma.com) and we're happy to increase them.

## Amounts

All monetary amounts are integers representing **cents**. For example, `150000` represents \$1,500.00.

## SDK

We are planning to ship a TypeScript SDK very soon. Message us if you're interested in an SDK for another language.