Introduction

The Axerity API gives you programmatic access to an organization's books and files. It's a RESTful JSON-over-HTTPS service with:

• Predictable resource URLs.
• Bearer-token authentication with per-org keys.
• Stripe-style error envelope.
• Cursor pagination on every list endpoint.

This is v1. The base URL is:

https://axerity.com/api/v1

Conventions

• Auth. Authorization: Bearer ax_live_... on every request.
• Errors. Non-2xx responses have a JSON body: { "error": { "type", "code", "message", "param" } }. See Errors.
• Lists. Cursor-paginated: { "object": "list", "data": [...], "has_more", "next_cursor", "url" }. See Pagination.
• Money. Decimal strings of minor units ("1234" USD = $12.34). See Money and dates.
• Dates. ISO 8601 strings; date-only fields use YYYY-MM-DD.

What's covered

The full surface lives under these resources:

• Accounts — chart of accounts
• Transactions — journal entries
• Reports — income statement, balance sheet, trial balance
• Folders — file workspace folders
• Files — uploads, downloads, metadata
• Audit log — file access history

Health check

A single unauthenticated endpoint:

curl https://axerity.com/api/v1

{
  "object": "service",
  "name": "axerity",
  "version": "v1"
}

→ Authentication