> ## Documentation Index > Fetch the complete documentation index at: https://docs.trycherry.ai/llms.txt > Use this file to discover all available pages before exploring further. # Push transactions into a manual bank account (write scope) > Import transactions into a manual bank institution previously created with POST /bank-accounts — the no-Plaid path for bringing your own bank feed. Rows land in the same pipeline Plaid-synced transactions use; Cherry categorizes and books them asynchronously (they appear uncategorized at first and are filed by the next sync sweep). **Sign convention (Plaid):** a POSITIVE `amount` means money LEFT the account (an expense/outflow); a NEGATIVE `amount` means money came in. Negate first if your export uses the opposite sign. **Idempotency:** each row's identity is the optional client `id` (reuse it across pushes for clean dedup) or, when omitted, a hash of date + amount + description. Re-posting the same payload updates rows in place instead of duplicating; duplicates within one payload are collapsed and counted in `deduplicated`. Requires the `write` scope. Body limit: 5 MB. ## OpenAPI ````yaml /openapi.json post /transactions openapi: 3.0.3 info: title: Cherry API version: 1.0.0 description: >- Cherry's public developer API — programmatic access to a business's books as Cherry keeps them: bank transactions with their categorizations, the chart of accounts, the double-entry journal, financial statements, legal entities, the tax-obligation calendar, and the fiscal health score. Authenticate every request with an API key: `Authorization: Bearer ck_live_…`. Keys are created in the Cherry app and are scoped to one business (tenant) — there is no tenant id in any URL. Keys carry a `read` and/or `write` scope; every GET needs `read`, mutations need `write`. Conventions: successful responses wrap the payload in `{ "data": … }`; list endpoints add `{ "meta": { "pagination": { limit, offset, nextOffset } } }` — pass `nextOffset` back as `offset` until it is null. Errors are `{ "error": string, "reason"?: string }` with conventional status codes. Dates are `YYYY-MM-DD`; money amounts are numbers in the row's currency. Requests are rate-limited per key with token buckets (429 + `Retry-After` when exhausted); report generation has a smaller budget than plain reads. servers: - url: https://api.trycherry.ai/v1 security: - bearerAuth: [] tags: - name: Transactions description: Bank feed rows and their categorizations. - name: Accounts description: The tenant's chart of accounts. - name: Bank accounts description: >- Connected bank accounts — Plaid-linked and manual. Manual institutions are how developers without a Plaid connection bring their own accounts and transactions. - name: Journal description: The double-entry journal (entries and lines). - name: Reports description: Trial balance and financial statements. - name: Entities description: Legal entities behind the tenant. - name: Obligations description: The tax/compliance calendar Cherry tracks. - name: Health description: Cherry's composite fiscal readiness score. - name: Meta description: The API's own machine-readable contract. paths: /transactions: post: tags: - Transactions summary: Push transactions into a manual bank account (write scope) description: >- Import transactions into a manual bank institution previously created with POST /bank-accounts — the no-Plaid path for bringing your own bank feed. Rows land in the same pipeline Plaid-synced transactions use; Cherry categorizes and books them asynchronously (they appear uncategorized at first and are filed by the next sync sweep). **Sign convention (Plaid):** a POSITIVE `amount` means money LEFT the account (an expense/outflow); a NEGATIVE `amount` means money came in. Negate first if your export uses the opposite sign. **Idempotency:** each row's identity is the optional client `id` (reuse it across pushes for clean dedup) or, when omitted, a hash of date + amount + description. Re-posting the same payload updates rows in place instead of duplicating; duplicates within one payload are collapsed and counted in `deduplicated`. Requires the `write` scope. Body limit: 5 MB. operationId: pushTransactions requestBody: required: true content: application/json: schema: type: object required: - institutionName - transactions properties: entityId: type: string format: uuid description: >- Optional assertion: must match the entity that owns the institution (409 otherwise). Omit to use the institution's entity. institutionName: type: string minLength: 1 maxLength: 80 description: >- Name of a manual institution created via POST /bank-accounts. transactions: type: array minItems: 1 maxItems: 1000 items: type: object required: - accountExternalId - date - amount - description properties: accountExternalId: type: string maxLength: 64 description: >- externalId of an account created via POST /bank-accounts. id: type: string maxLength: 64 pattern: ^[A-Za-z0-9._-]+$ description: >- Your stable transaction id — reuse it across pushes so re-imports update instead of duplicate. date: type: string format: date description: >- YYYY-MM-DD, 2000-01-01 or later, at most 7 days in the future. amount: type: number description: >- Plaid sign: positive = money OUT of the account, negative = money in. Major units in the row's currency. description: type: string minLength: 1 maxLength: 500 merchant: type: string maxLength: 200 description: >- Optional merchant label. Catch-all labels like "Other" or "Unknown" are dropped rather than stored. currency: type: string pattern: ^[A-Z]{3}$ description: ISO 4217; defaults to the account's currency. example: institutionName: First Community Bank transactions: - accountExternalId: checking-1234 id: stmt-2026-07-000041 date: '2026-07-14' amount: 129.99 description: AWS EMEA aws.amazon.com merchant: Amazon Web Services currency: USD - accountExternalId: checking-1234 date: '2026-07-15' amount: -2500 description: STRIPE PAYOUT responses: '200': description: Import result content: application/json: schema: type: object properties: data: type: object properties: received: type: integer description: Rows in the request payload. imported: type: integer description: Rows inserted or updated in the books. deduplicated: type: integer description: >- In-payload duplicates collapsed before writing (same computed identity). example: data: received: 2 imported: 2 deduplicated: 0 '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object required: - error properties: error: type: string description: Stable machine-readable error code. reason: type: string description: Human-readable explanation. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: ck_live_… description: >- Cherry API key, created in the app. Sent as `Authorization: Bearer ck_live_…`. ````