# Reports

> Laudos e relatorios de consultas de compliance.

**Base**: `https://api.prismadata.io/v1`

**Autenticação**: header `X-Apikey` (ou query `api_key`). Detalhes em [Autenticação](autenticacao.md).

**Formato de resposta**: JSON plano com campos `prismadata__<serviço>__<campo>`; em lote, dicionário indexado pelas chaves enviadas. Detalhes em [Formato de Resposta](guias/formato-de-resposta.md).

## Endpoints

### `GET /identity/ipinfo/reports`

Listagem paginada de consultas com filtros.

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/identity/ipinfo/reports" \
  -H "X-Apikey: SEU_TOKEN"
# Params opcionais: date_from=string, date_to=string, risk_level=string, country_code=string, is_vpn=False, is_sanctioned=False, page=1, page_size=50
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `date_from` | query | string \| null | não | Data inicio (ISO 8601) |
| `date_to` | query | string \| null | não | Data fim (ISO 8601) |
| `risk_level` | query | string \| null | não | Filtro por nivel de risco |
| `country_code` | query | string \| null | não | Filtro por pais (ISO 3166-1) |
| `is_vpn` | query | boolean \| null | não | Filtro por VPN detectada |
| `is_sanctioned` | query | boolean \| null | não | Filtro por sancao |
| `page` | query | integer | não | Pagina |
| `page_size` | query | integer | não | Itens por pagina |

**Response 200** (`application/json`):

> Successful Response

Tipo: `object`.

**Outros códigos**: 422, 429

---

### `GET /identity/ipinfo/report/{query_id}`

Retorna laudo PDF auditavel de uma consulta.

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/identity/ipinfo/report/string" \
  -H "X-Apikey: SEU_TOKEN"
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `query_id` | path | string | sim |  |

**Response 200** (`application/json`):

> Successful Response

Tipo: `object`.

**Outros códigos**: 422, 429

---

### `GET /identity/ipinfo/reports/download`

Download em lote de laudos PDF em formato ZIP (max 100).

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/identity/ipinfo/reports/download" \
  -H "X-Apikey: SEU_TOKEN"
# Params opcionais: date_from=string, date_to=string, risk_level=string, country_code=string, is_vpn=False, is_sanctioned=False
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `date_from` | query | string \| null | não | Data inicio (ISO 8601) |
| `date_to` | query | string \| null | não | Data fim (ISO 8601) |
| `risk_level` | query | string \| null | não | Filtro por nivel de risco |
| `country_code` | query | string \| null | não | Filtro por pais (ISO 3166-1) |
| `is_vpn` | query | boolean \| null | não | Filtro por VPN detectada |
| `is_sanctioned` | query | boolean \| null | não | Filtro por sancao |

**Response 200** (`application/json`):

> Successful Response

Tipo: `object`.

**Outros códigos**: 422, 429

---

## Recursos relacionados

- Documentação Redoc interativa: https://prismadata.io/redoc.html#tag/Reports
- OpenAPI só deste produto (JSON): https://prismadata.io/llm/openapi/reports.json
- OpenAPI completo: https://prismadata.io/openapi.yaml
- Índice geral: https://prismadata.io/llms.txt