/api/v1/health
Service health
Versioned HTTP API. The web app and API keys call the shared domain services. Send a session cookie, or Authorization: Bearer with a personal API key. Amounts are integer minor units. Every workspace route is limited to a workspace the caller belongs to. Version 0.1.0.
Send the session cookie from /api/auth, or a personal API key as Authorization: Bearer ldl_…. Keys are created in Settings and shown once. A key is limited to one workspace and to the scopes stamped on it (read, write). Managing keys requires a signed-in session.
The machine-readable document is /api/v1/openapi.json. Amounts are integer minor units. Each workspace is single-currency until conversion ships, and every route is scoped to a workspace the caller belongs to.
/api/v1/health
Service health
/api/v1/hints
Sign-up suggestions
/api/v1/me
Current user and workspaces
/api/v1/me
Delete my account and owned spaces
/api/v1/workspaces
Create a workspace
/api/v1/workspaces/{workspaceId}
Update workspace settings
/api/v1/workspaces/{workspaceId}/accounts
List payment accounts
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/accounts
Create a payment account
/api/v1/workspaces/{workspaceId}/accounts/{accountId}
Update a payment account
/api/v1/workspaces/{workspaceId}/categories
List categories
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/categories
Create a category
/api/v1/workspaces/{workspaceId}/categories/{categoryId}
Update or archive a category
/api/v1/workspaces/{workspaceId}/tags
List tags
/api/v1/workspaces/{workspaceId}/tags
Create a tag
/api/v1/workspaces/{workspaceId}/tags/{tagId}
Rename a tag
/api/v1/workspaces/{workspaceId}/tags/{tagId}
Delete a tag
/api/v1/workspaces/{workspaceId}/expenses
Search expenses
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/expenses
Record an expense
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}
Get an expense
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}
Update an expense
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}
Delete an expense
/api/v1/workspaces/{workspaceId}/invoice-qr/preview
Preview a Portuguese invoice QR code
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}/receipts
Upload a receipt
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}/receipts/{receiptId}
Download a receipt
/api/v1/workspaces/{workspaceId}/expenses/{expenseId}/receipts/{receiptId}
Delete a receipt
/api/v1/workspaces/{workspaceId}/reports/dashboard
Dashboard figures
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/reports/summary
Spending report
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/exports/expenses.csv
Export expenses as CSV
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/exports/report.pdf
Download a PDF report
qfromtocategoryIdtagIdaccountIdpayeesellerVatminMinormaxMinorsortdirectionpagepageSizeincludeArchivedasOfgroupBy/api/v1/workspaces/{workspaceId}/imports/preview
Preview a CSV import
/api/v1/workspaces/{workspaceId}/imports
Import a CSV
/api/v1/workspaces/{workspaceId}/imports
List imports
/api/v1/workspaces/{workspaceId}/imports/{importId}/undo
Undo an import
/api/v1/workspaces/{workspaceId}/import-mappings
List saved CSV mappings
/api/v1/workspaces/{workspaceId}/import-mappings
Save a CSV mapping
/api/v1/workspaces/{workspaceId}/import-mappings/{mappingId}
Delete a saved mapping
/api/v1/workspaces/{workspaceId}/api-keys
List API keys
/api/v1/workspaces/{workspaceId}/api-keys
Create an API key
/api/v1/workspaces/{workspaceId}/api-keys/{keyId}/revoke
Revoke an API key
/api/v1/workspaces/{workspaceId}/budgets
List budgets