> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/clientes/mov.-conta-corrente/list.md).

# List

Fornece uma lista de movimentos de conta-corrente do cliente.

## Listar Movimentos de Conta-Corrente do Cliente

<mark style="color:blue;">`GET`</mark> `https://api.cloudinvoice.net/customers/:cust_id/movements/`

#### Path Parameters

| Name     | Type    | Description   |
| -------- | ------- | ------------- |
| cust\_id | integer | ID do Cliente |

#### Query Parameters

<table data-search="false"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>limit</td><td>integer</td><td>Define o número de registos por pesquisa.</td></tr><tr><td>offset</td><td>integer</td><td><p>Indica a posição inicial da pesquisa.</p><p>Retorna a lista de registos compreendida entre <code>offset</code> e <code>offset+limit</code>.</p></td></tr><tr><td>document_header</td><td>integer</td><td>ID do Documento</td></tr><tr><td>document_reference</td><td>string</td><td><p>Referência do Documento</p><p></p><p>Sufixos disponíveis:</p><ul><li><code>__search</code>: para pesquisa parcial</li></ul></td></tr><tr><td>account_movement_type</td><td>integer</td><td>Tipo de Movimento<br><br>Consulte a tabela <a href="/documentacao-api/apendice.md#tipos-de-movimentos-de-conta-corrente-credito-ou-debito-campo-account_movement_type">Apêndice</a>.</td></tr><tr><td>is_automatic_entry</td><td>boolean</td><td>Movimento Gerado Automaticamente</td></tr><tr><td>is_movement_reconciled</td><td>boolean</td><td>Movimento Conciliado</td></tr></tbody></table>

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl https://api.cloudinvoice.net/customers/2/movements/
    -H "Content-Type: application/json"
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "limit": 10,
    "offset": 0,
    "count": 8,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1,
            "document_header_id": 1,
            "description": "Factura",
            "document_reference": "FAC A01/1",
            "party_id": 2,
            "movement_date": "2026-07-03",
            "movement_amount": 1.23,
            "due_date": "2026-07-03",
            "due_amount": 1.23,
            "is_automatic_entry": true,
            "is_movement_reconciled": false,
            "document_nature_id": 301,
            "document_nature": {
                "code": "FT",
                "description": "Factura"
            },
            "account_movement_type_id": 1753,
            "account_movement_type": {
                "code": "D",
                "description": "Débito"
            }
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)

{% hint style="info" %}
**Notas:** Alguns dos campos do termo de pesquisa geral poderão ser incluídos mediante critérios específicos (Ex: Descrição será incluída na pesquisa geral apenas se o termo de pesquisa contiver 3 ou mais caracteres). Por defeito, o comportamento expectável será obter-se todos os items cujo o texto a pesquisar (search) esteja CONTIDO em pelo menos um dos campos incluídos na pesquisa geral.
{% endhint %}