# Listar relatórios (/docs/pix-processamento/endpoints/reports/list_user_reports)

## GET /user/report

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

Lista os jobs de relatório criados pelo usuário autenticado.

Guia: Conciliação (/docs/pix-processamento/tutoriais/reconciliation)

### 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 |
| `status` | string | no | Status do relatório. `PENDING` `RUNNING` `COMPLETED` `FAILED` — `PENDING`, `RUNNING`, `COMPLETED`, `FAILED` |
| `createdAtFrom` | string | no | Filtro: criado a partir de. — format: date-time |
| `createdAtTo` | string | no | Filtro: criado até. — format: date-time |
| `updatedAtFrom` | string | no | Filtro: atualizado a partir de. — format: date-time |
| `updatedAtTo` | string | no | Filtro: atualizado até. — format: date-time |
| `sortBy` | string | no | Campo de ordenação. — `createdAt`, `updatedAt`; default: createdAt |
| `sortDirection` | string | no | Direção da ordenação. — `asc`, `desc`; default: desc |

### Responses

**200** Página de jobs de relatório

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `total` | integer | no | Quantidade de solicitações de relatório do usuário que atendem aos filtros. |
| `pages` | integer | no | Número de páginas para o limit informado, calculado a partir de total arredondado para cima. |
| `reports` | object[] | no | Solicitações de relatório da página pedida, com id, status e datas. |
| `reports.id` | string | no | Identificador (UUID) do relatório, gerado no momento da solicitação. — format: uuid |
| `reports.status` | string | no | Andamento da geração: PENDING, RUNNING, COMPLETED ou FAILED. — `PENDING`, `RUNNING`, `COMPLETED`, `FAILED` |
| `reports.createdAt` | string | no | Data e hora em que a geração do relatório foi solicitada. — format: date-time |
| `reports.updatedAt` | string | no | Data e hora da última alteração no registro do relatório. — format: date-time |
| `reports.expiresAt` | string | null | no | Quando o arquivo expira do armazenamento (normalmente 7 dias após a criação) — format: date-time |

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