> ## Documentation Index
> Fetch the complete documentation index at: https://run-deliverys.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```json theme={null}
{
  "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 |

<Info>
  **Business isolation.** Your API key can only access resources belonging to your Business. Cross-business access is denied.
</Info>

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

<ResponseExample>
  ```json 400 theme={null}
  {
    "statusCode": 400,
    "timestamp": "2026-08-12T15:18:51.396Z",
    "path": "/api/v2/business/orders",
    "message": "Insufficient wallet balance"
  }
  ```

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

  ```json 403 theme={null}
  {
    "statusCode": 403,
    "timestamp": "2026-08-12T15:18:51.396Z",
    "path": "/api/v2/business/order/cost",
    "message": "Insufficient API key scope"
  }
  ```

  ```json 404 theme={null}
  {
    "statusCode": 404,
    "timestamp": "2026-08-12T15:18:51.396Z",
    "path": "/api/v2/business/orders/6a7c75f801df3fbb7fad0c58",
    "message": "Order not found"
  }
  ```

  ```json 429 theme={null}
  {
    "statusCode": 429,
    "timestamp": "2026-08-12T15:18:51.396Z",
    "path": "/api/v2/business/orders",
    "message": "Too many requests"
  }
  ```

  ```json 500 theme={null}
  {
    "statusCode": 500,
    "timestamp": "2026-08-12T15:18:51.396Z",
    "path": "/api/v2/business/orders",
    "message": "Internal server error"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.