# 列出回调 (/zh/docs/pix-processamento/endpoints/callbacks/get_user_callbacks)

## GET /user/callbacks

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

Returns a paginated list of webhook callback logs for the user's transactions.

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

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `page` | integer | no | Page number. — minimum: 1; default: 1 |
| `limit` | integer | no | Items per page. — minimum: 1; maximum: 100; default: 10 |
| `sortBy` | string | no | Sort field. — `createdAt`, `status`; default: createdAt |
| `sortDirection` | string | no | Sort direction. — `asc`, `desc`; default: desc |
| `id` | string | no | Filter by callback ID |
| `url` | string | no | Filter by callback URL |
| `status` | integer | no | HTTP status code |
| `transactionId` | string | no | Transaction ID. |
| `hasError` | boolean | no | Filter callbacks that errored |
| `createdAtFrom` | string | no | Start of the creation date range. — format: date-time |
| `createdAtTo` | string | no | End of the creation date range. — format: date-time |

### Responses

**200** List of callback logs with pagination

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `pagination` | object | no | Page and limit used, and whether there is a next page. |
| `pagination.page` | integer | no | Current page — format: int32 |
| `pagination.limit` | integer | no | Items per page — format: int32 |
| `pagination.hasNextPage` | boolean | no | Indicates if there is a next page |
| `callbacks` | object[] | no | Array of callback logs |
| `callbacks.id` | string | no | Unique callback ID |
| `callbacks.url` | string | no | Webhook URL that received the callback |
| `callbacks.status` | number | no | HTTP response status code |
| `callbacks.transactionId` | string | no | Related transaction ID |
| `callbacks.createdAt` | string | no | Date and time when the callback log was created — format: date-time |
| `callbacks.body` | object | no | Request body sent (parsed JSON) |
| `callbacks.responseBody` | string | no | Response body received (string) |
| `callbacks.responseHeaders` | object | no | Response headers (parsed JSON) |
| `callbacks.responseTime` | number | no | Webhook round-trip time in milliseconds |

**400** Bad Request, payload or query string failed validation

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Fixed marker of an error response. |
| `error` | string | yes | Name of the corresponding HTTP status. |
| `errorCode` | string | yes | Stable machine-readable error code, when available. |
| `message` | string | yes | Human-readable error message. |
| `statusCode` | integer | yes | HTTP status code. |
| `requestId` | string | yes | Unique request correlation ID (cuid). Include it when contacting support. |
| `details` | object[] | no | Field-level validation errors, when applicable. |
| `details.field` | string | yes | Path of the field rejected in validation, without the leading slash. |
| `details.message` | string | yes | Reason that field was rejected, in Portuguese. |
| `retryAfterSeconds` | integer | no | Seconds to wait before retrying. Present only on 429 responses. |

**401** Unauthorized, missing or invalid Bearer token, or token lacks the required permission for this endpoint

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Fixed marker of an error response. |
| `error` | string | yes | Name of the corresponding HTTP status. |
| `errorCode` | string | yes | Stable machine-readable error code, when available. |
| `message` | string | yes | Human-readable error message. |
| `statusCode` | integer | yes | HTTP status code. |
| `requestId` | string | yes | Unique request correlation ID (cuid). Include it when contacting support. |
| `details` | object[] | no | Field-level validation errors, when applicable. |
| `details.field` | string | yes | Path of the field rejected in validation, without the leading slash. |
| `details.message` | string | yes | Reason that field was rejected, in Portuguese. |
| `retryAfterSeconds` | integer | no | Seconds to wait before retrying. Present only on 429 responses. |