Core endpoints
These are the business endpoints an agent uses to run the books. They all live under the base https://api.aikount.com with the /api/v1 prefix, and all require Authorization: Bearer <token> (see Authentication).
Use only the endpoints listed here. For the full, exact list of parameters and responses, consult the OpenAPI spec at
https://api.aikount.com/openapi.json, which is the source of truth.
Core
| Endpoint | What for |
|---|---|
GET /api/v1/tenants/me | Verify the token and see the active company (tenant). This is the one to use with agl_ keys. |
GET/POST /api/v1/invoices | Sales invoices. |
GET/POST /api/v1/purchases | Purchase invoices / expenses. |
POST /api/v1/ai/ingest-purchase | Ingest a purchase PDF: the agent reads it by OCR and books it (with deduplication). |
GET /api/v1/treasuries | Treasuries (bank accounts, Stripe, PayPal) with their balance. |
GET /api/v1/bank-movements | Bank movements. Filter by account with ?treasury_id=. |
POST /api/v1/reconciliation/manual-match | Reconcile manually: link {movement_id, document_id}. |
GET /api/v1/reconciliation/board | The reconciliation suggestions board. |
GET /api/v1/taxes | Tax types (with their UUIDs). Lines reference a tax by tax_type_id. |
GET /api/v1/ledger | Ledger / journal entries (PGC). |
GET /api/v1/aeat/303 | Modelo 303 (VAT) as CSV, with ?year=&quarter=. |
About the 303
GET /api/v1/aeat/303?year=2026&quarter=2returns the model's CSV for that period.GET /api/v1/aeat/303/summaryreturns the JSON history.
Remember: Aikount prepares the models from your real accounting; filing with the AEAT is done by you or your accountant.
/auth/me does not work for API keys
/auth/me is session-only (login) and rejects API keys. If your agent uses an agl_ key, verify the token with /api/v1/tenants/me, not /auth/me.
Conventions that apply to all
- Money in decimal euros (
1200.00), not cents. - Dates in ISO-8601; IDs as UUIDs.
- List endpoints accept
limit,offset,from,to. - Errors: HTTP status plus
{"detail": "..."}.
The details are in API conventions. For the full list of endpoints by resource, see the API reference.