API reference

Account

The chart of accounts. Each says what it can be chosen for, using the same rules as TallyPip's own forms.

GET /accounts

The account object

object string: string; Always "account".
id id: id; The account's id (a UUID). Use it to fetch it, or to refer to it from other things.
code string: string; Its number, like 1000 or 6100.
name string: string; Its name. A sub-account's is its full name, like “Utilities / Telephone”.
type string: string; asset, liability, equity, income or expense.
parent_id id or null: id or null; The account it's a sub-account of, or null.
description string or null: string or null; Notes about it.
active boolean: boolean; False once it's made inactive in TallyPip (it's kept, with its history, but left out of pickers).
pay_from boolean: boolean; An expense can be paid from it (bank, cash, credit card).
deposit_to boolean: boolean; A payment can be deposited into it (bank, cash, Undeposited Funds).
expense_category boolean: boolean; Bill and expense lines can use it as their category.
income boolean: boolean; Invoice lines and products can use it for income.
created_at timestamp: timestamp; When it was added, in UTC.

Example

{
  "object": "account",
  "id": "3f6c1e2a-8b4d-4c1e-9a7b-2d5e6f708130",
  "code": "6100",
  "name": "Supplies",
  "type": "expense",
  "parent_id": null,
  "description": null,
  "active": true,
  "pay_from": false,
  "deposit_to": false,
  "expense_category": true,
  "income": false,
  "created_at": "2026-10-06T14:30:00.000Z"
}

List accounts

GET /api/v1/accounts

The chart of accounts, each saying what it can be chosen for (pay_from, deposit_to, expense_category, income).

Key: any (Read only works).

Query

limit integer: integer; How many, 1 to 100 (default 25).
starting_after id: id; The last id of the page before, for the next page (when has_more is true).

Newest first. Answers a list: { object: "list", url, has_more, data }.

Request

curl https://tallypip.com/api/v1/accounts?limit=3 \
  -H "Authorization: Bearer tpk_your_key"

Answer: 200

{
  "object": "list",
  "url": "/api/v1/accounts",
  "has_more": false,
  "data": [
    {
      "object": "account",
      "id": "3f6c1e2a-8b4d-4c1e-9a7b-2d5e6f708130",
      "code": "6100",
      "name": "Supplies",
      "type": "expense",
      "parent_id": null,
      "description": null,
      "active": true,
      "pay_from": false,
      "deposit_to": false,
      "expense_category": true,
      "income": false,
      "created_at": "2026-10-06T14:30:00.000Z"
    }
  ]
}

Try it

With your own key (Settings › Connected apps). It stays in this page only, and reading can't change anything.