# Ofício Requisitório

> A API de Oficios Requisitorios permite consultar informacoes sobre precatorios e RPVs (Requisicoes de Pequeno Valor) vinculados a credores identificados por CPF ou CNPJ.

**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 /credit/precatorio_rpv/consulta_credito`

Retorna um resumo consolidado dos creditos (precatorios e RPVs) de determinado credor, incluindo quantidades e valores estimados atualizados.

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/credit/precatorio_rpv/consulta_credito" \
  -H "X-Apikey: SEU_TOKEN"
# Params opcionais: id_credor=string, nome_credor=string
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `id_credor` | query | string \| null | não | CPF ou CNPJ do credor que se deseja consultar |
| `nome_credor` | query | string \| null | não | Nome do credor que se deseja consultar os créditos |

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

> Successful Response

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| `prismadata__precatorio_rpv__id_credor` | integer \| string | sim | CPF ou CNPJ do credor consultado |
| `prismadata__precatorio_rpv__nome_credor` | string | sim | Nome completo do credor |
| `prismadata__precatorio_rpv__tipo_id_credor` | string | sim | Tipo do identificador (CPF ou CNPJ) |
| `prismadata__precatorio_rpv__quantidade_creditos_precatorio` | integer | sim | Quantidade de precatorios vinculados ao credor |
| `prismadata__precatorio_rpv__valor_estimado_creditos_precatorio` | number | sim | Valor estimado atualizado dos precatorios em reais |
| `prismadata__precatorio_rpv__quantidade_creditos_rpv` | integer | sim | Quantidade de RPVs vinculados ao credor |
| `prismadata__precatorio_rpv__valor_estimado_creditos_rpv` | number | sim | Valor estimado atualizado das RPVs em reais |

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

---

### `GET /credit/precatorio_rpv/detalha_credito`

Retorna a lista completa de oficios requisitorios com informacoes detalhadas de cada credito, incluindo numeros de processo, tribunal, valores e datas de expedicao.

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/credit/precatorio_rpv/detalha_credito" \
  -H "X-Apikey: SEU_TOKEN"
# Params opcionais: id_credor=string, nome_credor=string
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `id_credor` | query | string \| null | não | CPF ou CNPJ do credor que se deseja consultar |
| `nome_credor` | query | string \| null | não | Nome do credor que se deseja consultar os créditos |

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

> Successful Response

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| `items` | array[object] | sim | Lista de oficios requisitorios |

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

---

## Recursos relacionados

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