Error Codes - Turtle Docs

All endpoints return errors in a consistent shape with code, status, error string, and context object. Each endpoint page repeats the codes that matter for that call in its own Error Handling section; this table is the cross-cutting reference.

{
  "code": 400,
  "status": "INVALID_ARGUMENT",
  "error": "Description of what went wrong",
  "context": {
    "field": "Additional context about the error"
  }
}

Error reference

Status Code	Error	When It Occurs	How to Handle
400 Bad Request	`INVALID_ARGUMENT`	Invalid parameters or missing required fields	Check request body and query params against the API reference
401 Unauthorized	`UNAUTHORIZED`	Invalid or missing API key	Verify your `pk_live_` or `sk_live_` key is set on the `X-API-Key` header. See API Keys
404 Not Found	`NOT_FOUND`	Opportunity, distributor, or membership not found	Confirm the ID exists and the wallet is a member. See Register Wallet
409 Conflict	`CONFLICT`	Membership already exists for this wallet address	Call `GET /v2/membership/` first to check before creating. See Register Wallet
500 Internal Server Error	`INTERNAL`	Server-side failure	Retry with exponential backoff, contact support if persistent

​Error reference

Error reference