Axiomatic

API Reference

Interactive reference for the Axiomatic REST API. Browse endpoints, view schemas, and send test requests.

Overview

The Axiomatic API follows RESTful conventions. All endpoints accept and return JSON.

Base URL: https://app.axiomatic.us/api

Authentication

Requests require one of:

  • Session cookie — set automatically when signed in via the web app
  • API key — pass via the x-api-key header
curl https://app.axiomatic.us/api/entities \
  -H "x-api-key: YOUR_API_KEY"

Endpoints

Browse the sidebar for interactive documentation on every endpoint, organized by category:

CategoryDescription
HealthSystem status check
EntitiesCreate and manage legal entities
BooksMulti-book accounting (GAAP, IFRS, tax)
AccountsChart of accounts CRUD
Account MappingsMap roles to accounts for automated posting
EventsRecord financial events
ProcessTrigger the posting engine
JournalQuery and manage journal entries
Trial BalancePer-account debit/credit totals
PeriodsAccounting period lifecycle
ReportsBalance sheet, income statement, cash flow
Fund ReportsFund-specific reporting
ARInvoices, customers, payments
APBills, vendors, payments
TreasuryCash positions and linked accounts
FX RatesExchange rate management
FX RevaluationPeriod-end currency revaluation
Rule PacksDSL posting rules
ReconciliationTransaction matching and confirmation

Rate Limits

API requests are rate-limited per API key. Current limits:

  • 100 requests/minute for read endpoints (GET)
  • 30 requests/minute for write endpoints (POST/PUT/PATCH/DELETE)

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709164800

Errors

All errors return a JSON body with an error field:

{ "error": "Entity not found" }
StatusMeaning
400Bad request — missing or invalid parameters
401Unauthorized — missing or invalid credentials
404Not found — resource doesn't exist
429Rate limited — too many requests
500Server error — unexpected failure

On this page