---
title: "Consulta o histório de um protesto por ID ou por TituloID"
method: GET
path: "/api/v2/protestos/historico"
tags: ["ProtestoV2"]
---

# Consulta o histório de um protesto por ID ou por TituloID

`GET /api/v2/protestos/historico`

## Request

- Base URL: `https://pagamentos.meuk8.com.br/CobrancasAPI`
- URL: `https://pagamentos.meuk8.com.br/CobrancasAPI/api/v2/protestos/historico`
- Auth: OAuth 2
  - Password
  - Token URL: `/CobrancasAPI/token` scopes: `BknBankCobrancasAPI`

### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| ProtestoId | GUID | Identificador único do protesto que se deseja consultar o histórico | Não(1) |
| TituloId | Texto | Identificador do título do protesto que se deseja consultar o histórico | Não(2) |

(1) - Obrigatório caso TituloId não seja informado.
(2) - Obrigatório caso ProtestoId não seja informado.

### Resposta
| **Campo** | **Tipo** | **Descrição** |
|--|--|--|
| Total | Número | Quantidade total de itens do historico |
| **Itens** | **Lista de Objetos** | **Lista de objetos com as informações do registro de histórico** |
| Data | Data | Data da alteração da situação do título (formato: dd/mm/yyyy hh:mm:ss) |
| Situacao | Texto | Situacao do título na data informada |
| Cartorio | Texto | Nome do cartório onde o título foi protocolado (1) |
| Protocolo | Texto | Número de protocolo do título no cartório (1) |
| DataProtocolo | Data | Data de protocolo do título no cartório (formato: dd/mm/yyyy hh:mm:ss) (1) |
| Motivo | Texto | Motivo da devolução do título (2) |
| DescricaoMotivo | Texto | Descrição do motivo da devolução do título (2) |
| ValorPago | Numérico | Valor pago pelo devedor, sem custas cartorarias (3) |
| DataTransferencia | Data | Data da transferência do valor pago para a conta do cliente (formato: dd/mm/yyyy hh:mm:ss) (3) |

(1) - Só é informado se o título estiver com situação NO_CARTORIO ou posterior.
(2) - Só é informado se o título estiver com situação DEVOLVIDO.
(3) - Só é informado se o título estiver com situação PAGO.

## Query parameters

- `ProtestoId` string, uuid
- `TituloId` integer

## Headers

- `Aeskey` string, required

## Response `200`

Histórico consultado com sucesso

- BknBankPagamentosBusinessModelsResponseConsultaHistoricoProtestoResponse
  - `Total` integer
  - `Itens` BknBankPagamentosBusinessModelsResponseConsultaHistoricoProtestoResponseItem[]
    - `Data` string
    - `Situacao` string
    - `Cartorio` string
    - `Protocolo` string
    - `DataProtocolo` string
    - `Motivo` string
    - `DescricaoMotivo` string
    - `ValorPago` string
    - `DataTransferencia` string

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `404`: Nenhum protesto encontrado com o ID informado
- `500`: Erro interno no servidor

---

[API](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as/revisions/4b96dba8717a?raw)