Quickstart

Create a key and read your books in two minutes.

1. Create an API key

In the Cherry app, go to Settings → API keys and create a key. It’s yours alone. The token is shown once, so store it somewhere safe. (Owners and admins can always create keys; other roles need API access enabled by an admin.)

Keys look like ck_live_… and are scoped to the business they were created in. A read key can only read; a write key can also push and categorize.

2. Make a request

cURL

curl https://api.trycherry.ai/v1/transactions \
  -H "Authorization: Bearer ck_live_your_key_here"

{
  "data": [
    {
      "id": "manual:chase:chk-1:9f2a…",
      "date": "2026-08-15",
      "amount": 49.99,
      "description": "Figma subscription",
      "merchant": "Figma",
      "category": "6110",
      "categoryName": "Software & Subscriptions"
    }
  ],
  "meta": { "pagination": { "limit": 50, "offset": 0, "nextOffset": null } }
}

Amounts follow the banking sign convention: positive is money out, negative is money in.

3. Read your statements

cURL

curl "https://api.trycherry.ai/v1/reports/statements/profit_and_loss?from=2026-01-01&to=2026-06-30" \
  -H "Authorization: Bearer ck_live_your_key_here"

Where to go next

• End-to-end walkthrough. Push a transaction, watch it get categorized, and see it on your P&L.
• Push your own bank accounts and transactions. No Plaid required.
• Connect an agent over MCP.
• The full API Reference tab above. Every endpoint, generated from the live OpenAPI spec.