Ledgers

Open an entity's accrual ledger so you can post to it and report on it.

A ledger is the set of double-entry postings an entity keeps on one accounting basis. Every entity already keeps a cash ledger. The accrual ledger is opt-in, and opening it is the whole of this surface: once it exists you address it as ledgerBasis=accruals on Journal Entries and Reports.

The call is idempotent. An entity keeps one ledger per basis, so repeating it returns the existing ledger with 200 rather than opening a second one, and basis: "cash" resolves to the cash ledger the entity already has. Entities Kick does not keep books for, meaning personal entities and businesses with no legal type, are rejected with 400.

Open a ledger

post

Opens the entity's ledger for the given accounting basis and returns it. Kick backfills the ledger from the entity's existing bookkeeping, so postings made before the accrual ledger existed are reflected in it. The call is idempotent: an entity keeps one ledger per basis, and repeating it returns the existing ledger with 200 instead of creating another. Entities Kick does not keep books for (personal entities, and businesses with no legal type) are rejected with 400.

Authorizations

AuthorizationstringRequired

Organization access token issued by Kick, sent as Authorization: Bearer kick_org_....

Path parameters

entityIdstring · uuidRequired

Header parameters

Idempotency-Keystring · min: 1 · max: 255Optional

A unique key that makes the request idempotent. Retrying with the same key within 24 hours replays the original response (marked with Idempotent-Replayed: true) instead of executing again.

Body

basisstring · enumRequired

Accounting basis of the ledger to open. accruals opens the entity's accrual ledger; cash resolves to the cash ledger every entity already keeps.

Possible values:

Responses

200

200

application/json

201

201

application/json

400

400

application/json

401

401

application/json

403

403

application/json

404

404

application/json

429

429

application/json

post/platform/v1/entities/{entityId}/ledgers

POST /api/platform/v1/entities/{entityId}/ledgers HTTP/1.1
Host: use.kick.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "basis": "cash"
}

{
  "ledger": {
    "basis": "cash",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text"
  }
}