Errors

HTTP status codes and error response shape for the Business API.

When a request fails, Run returns a JSON body with a clear message:

{
  "statusCode": 401,
  "timestamp": "2026-08-12T15:18:51.396Z",
  "path": "/api/v2/business/orders",
  "message": "Invalid API key"
}

Response status codes

Status	Meaning	Examples
200	Success	Quote returned, order listed
201	Created	Order placed
400	Bad request	Invalid body fields, insufficient wallet balance
401	Unauthorized	Missing key, invalid key, revoked key, wrong-env prefix
403	Forbidden	API key missing required scope
404	Not found	Order id does not exist (or is not yours)
429	Too many requests	Rate limit exceeded — retry with backoff
500	Internal server error	Unexpected server failure

Error body

Field	Type	Description
statusCode	number	HTTP status code
timestamp	string	ISO 8601 time of the error
path	string	Request path that failed
message	string	Human-readable error detail

Business isolation. Your API key can only access resources belonging to your Business. Cross-business access is denied.

Log path and statusCode from error responses for support. Never log full API keys or Authorization headers.

400

{
  "statusCode": 400,
  "timestamp": "2026-08-12T15:18:51.396Z",
  "path": "/api/v2/business/orders",
  "message": "Insufficient wallet balance"
}