# Listar callbacks (/docs/pix-processamento/endpoints/callbacks/get_user_callbacks)

## GET /user/callbacks

`GET https://api.payzu.processamento.com/v1/user/callbacks`

Retorna uma lista paginada de logs de callback (webhook) das transações do usuário.

Guia: Webhooks (/docs/pix-processamento/webhooks)

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `page` | integer | no | Número da página. — minimum: 1; default: 1 |
| `limit` | integer | no | Itens por página. — minimum: 1; maximum: 100; default: 10 |
| `sortBy` | string | no | Campo de ordenação. — `createdAt`, `status`; default: createdAt |
| `sortDirection` | string | no | Direção da ordenação. — `asc`, `desc`; default: desc |
| `id` | string | no | Filtra por ID de callback |
| `url` | string | no | Filtra por callback URL |
| `status` | integer | no | Status HTTP devolvido pelo seu endpoint. |
| `transactionId` | string | no | ID da transação. |
| `hasError` | boolean | no | Filtra callbacks que apresentaram erro |
| `createdAtFrom` | string | no | Data de criação inicial. — format: date-time |
| `createdAtTo` | string | no | Data de criação final. — format: date-time |

### Responses

**200** Lista de callbacks

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `pagination` | object | no | Página e limite usados, e se há próxima página. |
| `pagination.page` | integer | no | Página atual — format: int32 |
| `pagination.limit` | integer | no | Itens por página — format: int32 |
| `pagination.hasNextPage` | boolean | no | Indica se há uma próxima página |
| `callbacks` | object[] | no | Array de logs de callback |
| `callbacks.id` | string | no | ID único do callback |
| `callbacks.url` | string | no | URL do webhook que recebeu o callback |
| `callbacks.status` | number | no | Código de status HTTP da resposta |
| `callbacks.transactionId` | string | no | ID da transação relacionada |
| `callbacks.createdAt` | string | no | Data e hora em que o log do callback foi criado — format: date-time |
| `callbacks.body` | object | no | Corpo da requisição enviado (JSON parseado) |
| `callbacks.responseBody` | string | no | Corpo da resposta recebido (string) |
| `callbacks.responseHeaders` | object | no | Cabeçalhos da resposta (JSON parseado) |
| `callbacks.responseTime` | number | no | Tempo de ida e volta do webhook em milissegundos |

**400** Bad Request

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Marcador fixo de resposta de erro. |
| `error` | string | yes | Nome do status HTTP correspondente. |
| `errorCode` | string | yes | Código de erro estável e legível por máquina, quando disponível. |
| `message` | string | yes | Mensagem de erro legível. |
| `statusCode` | integer | yes | Código de status HTTP. |
| `requestId` | string | yes | ID único de correlação da requisição (cuid). |
| `details` | object[] | no | Erros de validação por campo, quando aplicável. |
| `details.field` | string | yes | Caminho do campo rejeitado na validação, sem a barra inicial. |
| `details.message` | string | yes | Motivo da rejeição daquele campo, em português. |
| `retryAfterSeconds` | integer | no | Segundos a aguardar antes de tentar novamente. |

**401** Unauthorized

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Marcador fixo de resposta de erro. |
| `error` | string | yes | Nome do status HTTP correspondente. |
| `errorCode` | string | yes | Código de erro estável e legível por máquina, quando disponível. |
| `message` | string | yes | Mensagem de erro legível. |
| `statusCode` | integer | yes | Código de status HTTP. |
| `requestId` | string | yes | ID único de correlação da requisição (cuid). |
| `details` | object[] | no | Erros de validação por campo, quando aplicável. |
| `details.field` | string | yes | Caminho do campo rejeitado na validação, sem a barra inicial. |
| `details.message` | string | yes | Motivo da rejeição daquele campo, em português. |
| `retryAfterSeconds` | integer | no | Segundos a aguardar antes de tentar novamente. |