API Reference
The Imprest API is organized around REST. All requests and responses use JSON.
Base URL
https://imprest.ai/api/v1Content Type
All requests must include:
Content-Type: application/jsonErrors
The API uses standard HTTP status codes. Errors include a JSON body with details.
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad request — invalid parameters |
| 401 | Unauthorized — invalid or missing token |
| 403 | Forbidden — insufficient permissions |
| 404 | Not found |
| 422 | Validation error — check the errors array |
| 429 | Rate limited — slow down |
| 500 | Internal server error |
{
"errors": [
"Customer can't be blank",
"At least one line item is required"
]
}Pagination
List endpoints accept a limit parameter (1–50, default 25). Results are returned in a single page. For large datasets, filter by date range or status to narrow results.
Rate Limiting
Coming Soon
Rate limiting is not yet enforced. We recommend keeping requests under 100 per minute per token. Rate limiting will be enforced in a future release with standard 429 responses and Retry-After headers.