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

# The response envelope

> One predictable shape for every response.

Responses are wrapped in a consistent envelope. `data` holds the payload; `pagination` appears only on paged lists; on failures `errors` is populated and `meta.status` becomes `FAILURE`.

```json theme={null}
{
  "data": /* payload: object or array */,
  "pagination": { "pageNumber": 1, "pageSize": 20, "totalElements": 151, "totalPages": 8 },
  "errors": [ { "errorCode": "...", "message": "...", "detail": "..." } ],
  "meta": { "status": "SUCCESS", "timestamp": "..." }
}
```

<Info>
  Gateway-level auth errors (401 / 403) are the exception: they have **no body at all**. Only errors from the services carry the `errors` envelope.
</Info>