# List reports (/en/docs/pix-processamento/endpoints/reports/list_user_reports)

## GET /user/report

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

List report jobs created by the authenticated user.

Guia: Reconciliation (/docs/pix-processamento/tutoriais/reconciliation)

### 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 |
| `status` | string | no | Report status. `PENDING` `RUNNING` `COMPLETED` `FAILED` — `PENDING`, `RUNNING`, `COMPLETED`, `FAILED` |
| `createdAtFrom` | string | no | Filter: created from. — format: date-time |
| `createdAtTo` | string | no | Filter: created up to. — format: date-time |
| `updatedAtFrom` | string | no | Filter: updated from. — format: date-time |
| `updatedAtTo` | string | no | Filter: updated up to. — format: date-time |
| `sortBy` | string | no | Sort field. — `createdAt`, `updatedAt`; default: createdAt |
| `sortDirection` | string | no | Sort direction. — `asc`, `desc`; default: desc |

### Responses

**200** Page of report jobs

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `total` | integer | no | Number of report requests of the user that match the filters. |
| `pages` | integer | no | Number of pages for the limit provided, computed from total rounded up. |
| `reports` | object[] | no | Report requests of the requested page, with id, status and dates. |
| `reports.id` | string | no | Report identifier (UUID), generated when the report is requested. — format: uuid |
| `reports.status` | string | no | Generation progress: PENDING, RUNNING, COMPLETED or FAILED. — `PENDING`, `RUNNING`, `COMPLETED`, `FAILED` |
| `reports.createdAt` | string | no | Date and time the report generation was requested. — format: date-time |
| `reports.updatedAt` | string | no | Date and time of the last change to the report record. — format: date-time |
| `reports.expiresAt` | string | null | no | When the file expires from storage (typically 7 days after creation) — format: date-time |

**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. |