Error response format
code field is present for structured errors but may be omitted for simple validation failures.
Overview
Errors
HTTP error codes and error response format.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
HTTP error codes and error response format.
{
"error": "Human-readable message",
"code": "MACHINE_READABLE_CODE"
}
code field is present for structured errors but may be omitted for simple validation failures.
| Status | Meaning |
|---|---|
| 400 | Validation error, missing payout wallet, bad request body |
| 401 | Missing or invalid API key |
| 403 | Insufficient scope or store mismatch |
| 404 | Resource not found |
| 409 | External order ID conflict |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
| Code | Description |
|---|---|
BOOTSTRAP_KEY_INVOICE_FORBIDDEN | Connection key used for invoice creation |
EXTERNAL_ORDER_INTEGRATION_CONFLICT | Order ID belongs to another integration |
INSUFFICIENT_SCOPE | API key lacks required scope |
SITE_ALREADY_CONNECTED | Woo site bound to another store |
INTEGRATION_NOT_FOUND | Woo integration not found on disconnect |
CURRENCY_NOT_ALLOWED | Invoice currency not in merchant allowlist |