Listar cessões

GET

/cession/list-cessions

Lista as cessões registradas no serviço de cessões, com paginação por page e filtro opcional por date. Cada item traz o identificador da cessão, o tipo, o arquivo da cessão, a quantidade de operações, o número da cessão, a situação, o valor total e a data de criação. Use o identificador em _id para listar as operações de uma cessão. A lista é repassada como devolvida pelo serviço de cessões. Quando o serviço de cessões recusa ou não atende a chamada, a rota devolve o mesmo status HTTP devolvido por ele, ou 500 se não houver resposta, com uma mensagem de falha na comunicação seguida, depois de "Detalhes:", do detalhe da falha entre aspas. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Cessões

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Falha no serviço de cessões (requisição recusada)

🟠404Falha no serviço de cessões (não encontrado)

🔴500Falha no serviço de cessões ou erro interno

Request Example

Shell

JavaScript

Java

Swift

curl --location '/cession/list-cessions?page=1&date=2026-09-14' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

[
    {
        "_id": "Qw3Er5Ty7Ui9Op1As2Df",
        "type": "tipo-exemplo",
        "zip_file_url": "cessoes/lote-0001.zip",
        "operation_counter": 3,
        "cession_number": 42,
        "status": "enviada",
        "total_value": 452300.75,
        "created_at": "2026-09-14T13:20:00.000Z"
    }
]

Modificado em 2026-10-13 09:47:06

Página anterior

Registrar cessão de operações

Próxima página

Listar operações de uma cessão