API reference

Tax rate

The business's saved sales tax rates, to put on invoice lines (tax_rate_id).

GET /tax-rates

The tax rate object

object string: string; Always "tax_rate".
id id: id; The tax rate's id (a UUID). Use it to fetch it, or to refer to it from other things.
name string: string; Its name (like NYC 8.875%).
rate number: number; The percentage.
agency string or null: string or null; Who it's paid to.
active boolean: boolean; False once it's made inactive in TallyPip (it's kept, with its history, but left out of pickers).
created_at timestamp: timestamp; When it was added, in UTC.

Example

{
  "object": "tax_rate",
  "id": "3f6c1e2a-8b4d-4c1e-9a7b-2d5e6f708108",
  "name": "NYC 8.875%",
  "rate": 8.875,
  "agency": "New York State",
  "active": true,
  "created_at": "2026-10-06T14:30:00.000Z"
}

List tax rates

GET /api/v1/tax-rates

Saved sales tax rates, to put on invoice lines.

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/tax-rates?limit=3 \
  -H "Authorization: Bearer tpk_your_key"

Answer: 200

{
  "object": "list",
  "url": "/api/v1/tax-rates",
  "has_more": false,
  "data": [
    {
      "object": "tax_rate",
      "id": "3f6c1e2a-8b4d-4c1e-9a7b-2d5e6f708108",
      "name": "NYC 8.875%",
      "rate": 8.875,
      "agency": "New York State",
      "active": true,
      "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.