---
title: "Retorna a lista de boletos quitados de aluguel do locatário na Área do Cliente"
method: GET
path: "/Locatario/RetornarBoletosQuitados"
tags: ["Locatário"]
---

# Retorna a lista de boletos quitados de aluguel do locatário na Área do Cliente

`GET /Locatario/RetornarBoletosQuitados`

## Request

- Base URL: `https://api.imoview.com.br`
- URL: `https://api.imoview.com.br/Locatario/RetornarBoletosQuitados`
- Auth: API key in header `chave`

Retorno JSON da lista de boletos quitados finalidade aluguel do locatário na área do cliente do imoview ADM

## Query parameters

- `numeroPagina` integer, required
- `numeroRegistros` integer, required
- `codigoCliente` integer, required

## Response `200`

Dados retornados com sucesso

- object
  - `quantidade` integer: Total de boletos quitados do locatário (para paginação)
  - `lista` object[]: Boletos quitados da página solicitada
    - `codigo` integer: Código do boleto
    - `situacao` string, string: Situação do boleto (aqui sempre Quitado)
    - `dataemissao` string, string: Data no formato dd/MM/yyyy de emissão
    - `datavencimento` string, string: Data no formato dd/MM/yyyy de vencimento
    - `dataquitacao` string: Data no formato dd/MM/yyyy da quitação. Vazio quando não registrada
    - `valor` number: Valor numérico com 2 casas decimais. Valor original do boleto
    - `valorpago` number: Valor numérico com 2 casas decimais. Valor efetivamente pago (pode diferir do valor por juros, multa ou desconto)
    - `movimentos` object[]: Movimentos (contas) cobrados no boleto, ordenados por vencimento
      - `codigo` integer: Código do movimento
      - `historico` string, string: Histórico/descrição do movimento
      - `datavencimento` string, string: Data no formato dd/MM/yyyy de vencimento do movimento
      - `datapagamento` string, string: Data no formato dd/MM/yyyy do pagamento do movimento. Vazio quando em aberto
      - `valor` number: Valor numérico com 2 casas decimais. Valor do movimento para o locatário
      - `detalhes` object[]: Lançamentos que compõem o movimento, agrupados por plano de contas
        - `planoconta` string, string: Nome do plano de contas
        - `codigocontabil` string, string: Código contábil do plano de contas
        - `historico` string, string: Histórico do lançamento. Vazio quando agrupado
        - `valor` number: Valor numérico com 2 casas decimais. Valor do lançamento (negativo = desconto)

## Other responses

- `401`: Header 'chave' ausente ou inválido, ou chave/usuário sem permissão para a operação
- `403`: Regra de negócio violada ou limite de paginação excedido
- `404`: Parâmetro obrigatório ausente ou inválido, registro não encontrado ou consulta sem resultado
- `429`: Limite de requisições da chave excedido
- `500`: Falha interna não prevista

## Changes

- **2026-10-09** `d7f65bff1506`: 5 breaking, 6 info
  - for the `query` request parameter `codigoCliente`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `numeroPagina`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `numeroRegistros`, the format changed from `Int64` to `int64`
  - the `lista/items/codigo` response's property format changed from `Int64` to `int64` for status `200`
  - …7 more

[Operation history](https://skmtc.dev/imoview/apis/imoview-api/changes/Locatario/RetornarBoletosQuitados/get.md)

---

[API](https://skmtc.dev/imoview/apis/imoview-api.md) - [All operations](https://skmtc.dev/imoview/apis/imoview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/imoview/apis/imoview-api/revisions/436e609983d0?raw)