Finance
Cost Categories
Cost categories and cost reports
Authentication
Authenticate with Authorization: Bearer ak_... — see API keys. Entity-scoped routes use entityId in the query or body; a mismatched entityId returns 403.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/cost-categories?entityId= | List cost categories |
| POST | /api/cost-categories | Create category |
| GET | /api/cost-reports?entityId= | Cost reports |
List cost categories
GET /api/cost-categories?entityId={entityId}
Returns cost categories for the entity.
Create category
POST /api/cost-categories
Body: { "entityId", "name", "code?", "parentId?", ... }
Cost reports
GET /api/cost-reports?entityId={entityId}
Returns cost reports. Supports period, categoryId, and other filters.