Skip to main content
The Crevio API lets you manage products, pricing, checkouts, orders, customers, and more. All endpoints return JSON and use standard HTTP methods.

Base URL

https://api.crevio.co/v1
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.

Pagination

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"]
    }
  }
}
StatusTypeDescription
400parameter_missingA required parameter is missing
401unauthorizedInvalid or missing API token
404not_foundResource not found
422validation_errorRequest failed validation
500errorInternal server error

SDKs

TypeScript

Install the official SDK:
npm install @crevio/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.