# Relatório PCI de um período (JSON, PDF ou CSV)

> Endpoint GET /reports/pci da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.

URL: https://docs.proteside.com/pt-BR/docs/api/reference/reports/getPciReport

## Método e rota

`GET /reports/pci`

Reutiliza o snapshot mais recente do mesmo período exato; caso contrário, gera um snapshot `on_demand`. `format=pdf` responde `302 Location: <signed URL, 1 h>` (ou os bytes do PDF quando o arquivo ainda não está no storage); `format=csv` transmite a tabela escolhida. `regenerate=true` força um novo snapshot e exige `reports:generate`. Exige um plano com relatórios de compliance ou um contrato de parceiro que os inclua (`403 plan_limit`).

## Parâmetros

- `org_id` (query, `string`): Somente parceiros (`orgs:manage`): atua sobre esta organização filha. Também pode ser enviado como `org_id` em corpos JSON.
- `store_id` (query, `string`, obrigatório)
- `period_start` (query, `string`): Padrão: period_end − 7 dias
- `period_end` (query, `string`): Padrão: agora. Intervalo máximo de 366 dias.
- `format` (query, `"json" | "pdf" | "csv"`)
- `csv_table` (query, `"scripts" | "headers" | "alerts"`)
- `locale` (query, `"pt-BR" | "en"`)
- `regenerate` (query, `boolean`)

## Respostas

- `200`: Snapshot (json) ou CSV
- `302`: PDF — redirecionamento para uma URL assinada (válida por 1 hora)
- `403`: O plano não permite a ação
- `404`: Não encontrado na organização em que se está atuando

Especificação OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
