> 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/documentos/list/documentos-internos.md).

# Documentos Internos

Fornece uma lista de documentos internos.

## Listar Documentos Internos

<mark style="color:blue;">`GET`</mark> `https://api.cloudinvoice.net/documents/internal_documents/`

#### Query Parameters

| Name             | Type    | Description                                                                                                                                                                                                                                                                                            |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| limit            | integer | Define o número de registos por pesquisa.                                                                                                                                                                                                                                                              |
| offset           | integer | <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>                                                                                                                                                     |
| ordering         | string  | <p>Define o campo e a direção a usar na pesquisa de registos. </p><p></p><p>Campos ordenáveis:</p><ul><li><code>id</code>, <code>doc\_key</code>, <code>document\_date</code>, <code>document\_time</code></li></ul><p>Use '-' antes do nome para ordem decrescente.</p>                               |
| search           | string  | <p>Define o termo de pesquisa a utilizar na lista de registos. </p><p></p><p>Campos Pesquisados:</p><ul><li><code>doc\_key</code>, <code>document\_name</code>, <code>our\_reference</code>, <code>party\_fiscal\_number</code>, <code>party\_name</code>, <code>salesman\_name</code>, etc.</li></ul> |
| document\_status | integer | <p>Estado do Documento</p><p></p><p>Consulte a tabela <a href="/documentacao-api/apendice.md#estados-dos-documentos-campo-document_status">Apêndice</a> para mais informação</p>                                                                                                                       |

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

```shell
curl https://api.cloudinvoice.net/documents/internal_documents/
    -H "Content-Type: application/json"
```

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 42,
    "next": "https://api.cloudinvoice.net/documents/internal_documents/?limit=10&offset=10",
    "previous": null,
    "results":[
        {
            "id": 1,
            "doc_key": "DINC A01/1",
            "document_date": "2026-09-09",
            "document_time": "17:54:18.033683",
            "document_number": 1,
            "our_reference": "",
            "is_valued": true,
            "is_tax_included": true,
            "total_amount": 39.9,
            "total_due_amount": 0.0,
            "due_date": "2026-09-09",
            "document_nature_id": 371,
            "document_id": 146,
            "document": {
                "code": "DINC",
                "document_name": "Documento Interno",
                "ask_payment_onclose": false
            },
            "document_serie_id": 1,
            "document_serie": {
                "code": "A01",
                "description": "Série A01"
            },
            "document_status_id": 1202,
            "warehouse_id": 1,
            "warehouse": {
                "code": 1,
                "description": "Armazém 1"
            },
            "document_nature": {
                "code": "DIN",
                "description": "Documento Interno"
            },
            "document_status": {
                "code": "F",
                "description": "Finalizado"
            },
            "party_id": 2,
            "party": {
                "class": 1601,
                "code": 2,
                "name": "Cliente Demo",
                "fiscal_number": "999999990"
            },
            "payment_method_id": null,
            "payment_method": null
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

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