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

# List

Fornece uma lista de todos os fornecedores existentes.

## Listar Fornecedores

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

#### 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       | <p>string<br><sub><mark style="color:$info;">Default: "code"</mark></sub></p> | <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>code</code>, <code>fiscal\_number</code>, <code>supplier\_name</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>code</code>, <code>supplier\_name</code>, <code>fiscal\_number</code>, etc.</li></ul>                                                              |
| code           | integer                                                                       | Código do Fornecedor                                                                                                                                                                                                                                                 |
| supplier\_name | string                                                                        | <p>Nome do Fornecedor</p><p></p><p>Sufixos disponíveis:</p><ul><li><code>\_\_search</code>: para pesquisa parcial</li></ul>                                                                                                                                          |
| fiscal\_number | String                                                                        | <p>Contribuinte</p><p></p><p>Sufixos disponíveis:</p><ul><li><code>\_\_search</code>: para pesquisa parcial</li></ul>                                                                                                                                                |

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

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

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 120,
    "next": "https://api.cloudinvoice.net/suppliers/?limit=10&offset=10",
    "previous": null,
    "results":[
        {
            "id": 1,
            "code": 1,
            "supplier_name": "Fornecedor 1",
            "fiscal_number": "500000000",
            "fiscal_country_id": 1,
            "fiscal_country": {"code": "PT", "country_name": "Portugal"},
            "fiscal_status_type_id": 1593,
            "fiscal_status_type": {"code": "2", "description": "Sujeito Passivo de IVA"},
            "street1": "",
            "street2": "",
            "zip_code": "",
            "zip_locale": "",
            "country_id": 1,
            "country": {"code": "PT", "country_name": "Portugal"},
            "phone1": "",
            "mobile1": "",
            "email1": "",
            "total_debits": 0.0,
            "total_credits": 100.0,
            "current_balance": 100.0
        },
        ...
    ]
}
```

{% 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 %}