> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses

> Response and error formats for the Stigg REST API

## Response format

All responses are returned in JSON format with consistent structure:

**Successful response:**

```json theme={null}
{
  "id": "customer-123",
  "name": "Acme Corp",
  "email": "billing@acme.com",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}
```

## Error handling

The API uses standard HTTP status codes and returns detailed error information in a consistent format.

| Status | Meaning                                                                                                |
| ------ | ------------------------------------------------------------------------------------------------------ |
| `200`  | Success — request completed, body contains the resource                                                |
| `201`  | Created — resource was successfully provisioned                                                        |
| `400`  | Bad request — invalid parameters or request body                                                       |
| `401`  | Unauthenticated — missing or invalid `X-API-KEY`                                                       |
| `403`  | Forbidden — authenticated but not authorized for this resource                                         |
| `404`  | Not found — the specified resource does not exist                                                      |
| `409`  | Conflict — e.g. a subscription already exists for this customer                                        |
| `429`  | Too many requests — rate limit exceeded; see [Rate Limits](/api-and-sdks/integration/rest/rate-limits) |


## Related topics

- [Debugging requests with trace IDs](/guides/i-want-to/debugging-with-trace-ids.md)
- [I want to run Stigg Sidecar and API in production](/guides/i-want-to/run-stigg-sidecar-api-in-production.md)
- [Check and ingest](/documentation/governance/check-and-ingest.md)
- [Getting temporary credentials for event queues](/guides/i-want-to/get-temporary-credentials-for-event-queues.md)
- [Query the governance tree](/documentation/governance/query.md)