API overview

The Meridia API is a RESTful HTTPS service at api.auxio.app/v1. Everything you can do in the dashboard — read orders, pull profit reports, trigger repricing — is available programmatically.

Authentication

Bearer tokens. Generate one from Settings → API → New token. Scope each token to the minimum required (read-only tokens are the default). Tokens can be revoked instantly and are never shown again after creation — store them securely.

Base URL and versioning

All endpoints live under /v1. Breaking changes graduate to /v2 with a twelve-month overlap; non-breaking additions ship to /v1 continuously. The current version is documented at /developers.

Rate limits

1,000 requests per minute per token, burst to 100 requests per second. Exceeding triggers a 429 with a Retry-After header. For bulk data needs, prefer the export endpoints (see below) over paginated list calls.

Core resources

/orders, /products, /channels, /profit-reports, /repricing-rules, /webhooks. Each supports standard REST verbs plus filter and sort query parameters documented inline at /developers/reference.

Exports

For large datasets (>10k rows), hit /v1/exports with the resource and filter you want. Meridia returns a signed URL to a gzipped JSON file, generated asynchronously within seconds to a few minutes depending on volume.

Errors

All errors return a structured JSON body with code, message, and (where relevant) hint. Codes are stable across versions — safe to branch on.