Tax
Tax Rates
Tax rates, reports, and returns
Authentication
Authenticate with Authorization: Bearer ak_... — see API keys. Requests are scoped to one entity. Pass entityId as a query parameter, JSON field, or x-entity-id header. API keys are already pinned to an entity. A mismatched entityId returns 403.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/ledger/tax-rates?entityId= | List tax rates |
| POST | /api/ledger/tax-rates | Create tax rate |
| GET | /api/ledger/tax-reports?entityId= | Tax reports |
| GET | /api/tax-returns?entityId= | Tax returns |
List tax rates
GET /api/ledger/tax-rates?entityId={entityId}
Returns tax rates configured for the entity.
Create tax rate
POST /api/ledger/tax-rates
Body: { "entityId", "name", "rate", "jurisdiction?", "type?", ... }
Tax reports
GET /api/ledger/tax-reports?entityId={entityId}
Returns tax reports. Supports period, jurisdiction, and other filters.
Tax returns
GET /api/tax-returns?entityId={entityId}
Returns tax returns for filing. Supports period, status, and other filters.