> ## 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. # In-flight incorporations > Companies being formed that have no legal-entity record yet, each grouped with its order lines (formation, registered agent, EIN) and their filing status. Once the formation files and the entity exists, its orders move to GET /filings. ## OpenAPI ````yaml /openapi.json get /incorporations 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, the fiscal health score, and company incorporations (formation, EIN, and state filings). 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: Bank statements description: >- Statement uploads — send a statement PDF/image and Cherry transcribes it, verifies the balances reconcile, and lands the transactions on a manual bank account. The no-export alternative to pushing rows yourself. - 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: Incorporations description: >- Company formation, EIN orders, and the state filings that follow — start a formation and track every filing to completion. - name: Meta description: The API's own machine-readable contract. paths: /incorporations: get: tags: - Incorporations summary: In-flight incorporations description: >- Companies being formed that have no legal-entity record yet, each grouped with its order lines (formation, registered agent, EIN) and their filing status. Once the formation files and the entity exists, its orders move to GET /filings. operationId: listIncorporations responses: '200': description: Pending incorporations, newest first content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PendingIncorporation' example: data: - companyId: comp_x1y2z3a4b5c6d7e8 legalName: Acme Ventures LLC entityType: LLC filingState: DE createdAt: '2026-08-19T18:04:11.000Z' items: - orderId: ord_a1b2c3d4e5f6a7b8 orderType: formation filingStatus: pending filingDate: null - orderId: ord_b2c3d4e5f6a7b8c9 orderType: registered_agent filingStatus: submitted filingDate: null '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: PendingIncorporation: type: object description: >- A company being formed, grouped with its order lines. It has no legal-entity record yet; once the formation files, its orders appear under /filings instead. properties: companyId: type: string description: Cherry's id for the company being formed. legalName: type: string nullable: true entityType: type: string nullable: true enum: - LLC - CORP - null filingState: type: string nullable: true description: US state being formed in. createdAt: type: string format: date-time items: type: array items: $ref: '#/components/schemas/IncorporationOrderItem' Error: type: object required: - error properties: error: type: string description: Stable machine-readable error code. reason: type: string description: Human-readable explanation. IncorporationOrderItem: type: object description: One order line inside an incorporation bundle. properties: orderId: type: string description: Stable order id. orderType: type: string description: >- formation, registered_agent, ein, annual_report, foreign_qualification. filingStatus: type: string enum: - submitted - pending - filed - exception - cancelled filingDate: type: string format: date nullable: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: ck_live_… description: >- Cherry API key, created in the app. Sent as `Authorization: Bearer ck_live_…`. ````