# Synthetic API

- [Introduction](https://docs.synthetic.ai/introduction.md): Read your company's books from Synthetic over a plain REST API.
- [Authentication](https://docs.synthetic.ai/authentication.md): Send your API key as a bearer token.
- [Errors](https://docs.synthetic.ai/errors.md): What an error response looks like and what each status means.
- [Pagination](https://docs.synthetic.ai/pagination.md): Page through a list with cursors.
- [List payments](https://docs.synthetic.ai/api-reference/payments/list-payments.md): Lists cash payments, newest received first unless `orderBy` asks for another order. Page with `limit` and the cursors from the previous page; `hasMore` says whether more rows lie in the direction being read. Keep the same filters and the same `orderBy` for the whole run.
- [Get a payment](https://docs.synthetic.ai/api-reference/payments/get-a-payment.md): One cash payment by id. A payment of another entity, or a bank fee on its own, is not found.
- [Identify the caller](https://docs.synthetic.ai/api-reference/system/identify-the-caller.md): Returns the entity the credential belongs to and the permissions it holds. Use it to confirm an API key works.
- [Check that the API is reachable](https://docs.synthetic.ai/api-reference/system/check-that-the-api-is-reachable.md): Returns OK when the public API is up. No credentials are needed, so use this to confirm connectivity before calling data routes.

## OpenAPI Specs

- [openapi](https://app.synthetic.ai/api/v1/openapi.json)