The Crevio API lets you manage products, pricing, checkouts, orders, customers, and more. All endpoints return JSON and use standard HTTP methods.
Base URL
For local development:
https://api.crevio.localhost/v1
Authentication
All API requests require a Bearer token in the Authorization header.
curl https://api.crevio.co/v1/products \
-H "Authorization: Bearer YOUR_API_TOKEN"
Generate API tokens from Settings > Developer > API tokens in your dashboard.
Keep your API tokens secure. Do not expose them in client-side code or public repositories.
List endpoints return paginated results with this structure:
{
"items": [...],
"pagination": {
"count": 50,
"page": 1,
"pages": 5,
"limit": 20,
"offset": 0,
"from": 1,
"to": 20,
"in": 20,
"last": 5,
"next": 2,
"previous": null
}
}
Use page and limit query parameters to navigate results. Default limit is 20, maximum is 100.
Expandable fields
Some endpoints support an expand query parameter to include related data. Pass a comma-separated list of fields:
curl "https://api.crevio.co/v1/orders?expand=line_items,customer,discount"
Errors
All errors follow this format:
{
"error": {
"type": "validation_error",
"message": "Validation failed",
"details": {
"email": ["is required"]
}
}
}
| Status | Type | Description |
|---|
| 400 | parameter_missing | A required parameter is missing |
| 401 | unauthorized | Invalid or missing API token |
| 404 | not_found | Resource not found |
| 422 | validation_error | Request failed validation |
| 500 | error | Internal server error |
SDKs
TypeScript
Install the official SDK:
import { Crevio } from "@crevio/sdk";
const crevio = new Crevio({
security: {
apiKey: "YOUR_API_TOKEN",
},
});
const products = await crevio.products.list();
Full endpoint reference
Browse all available endpoints below.