Quickstart

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 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 "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

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.

Getting started

Guides

1. Create an API key

2. Make a request

3. Read your statements

Where to go next

​1. Create an API key

​2. Make a request

​3. Read your statements

​Where to go next

1. Create an API key

2. Make a request

3. Read your statements

Where to go next