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

# List

Fornece uma lista de todas as tabelas de impostos existentes.

## Listar Tabelas de Impostos

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

#### 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: "tax\_sequence\_order"</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>description</code>, <code>short\_description</code>, <code>tax\_sequence\_order</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>description</code>, <code>short\_description</code>, <code>tax\_region</code>, <code>tax\_exemption</code>, etc.</li></ul>                                                             |

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

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

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 16,
    "next": "https://api.cloudinvoice.net/tax_tables/?limit=10&offset=10",
    "previous": null,
    "results": [
        {
            "id": 1,
            "code": 1,
            "description": "Taxa Normal",
            "short_description": "Taxa Normal",
            "tax_group_id": 1,
            "tax_group": {
                "id": "1",
                "code": "IVA",
                "description": "Imposto sobre o Valor Acrescentado",
                "short_description": "IVA"
            },
            "tax_region_id": 1,
            "tax_region": {
                "id": "1",
                "code": "PT",
                "description": "Continente"
            },
            "tax_zone_id": 21,
            "tax_zone": {
                "id": 21,
                "description1": "Mercado Nacional"
            },
            "tax_type_id": 41,
            "tax_type": {
                "id": 41,
                "description1": "IVA-Imposto sobre o Valor Acrescentado"
            },
            "tax_code_id": 31,
            "tax_code": {
                "id": 31,
                "description1": "Taxa Normal"
            },
            "tax_rate": "23,00%",
            "tax_sequence_order": 1,
            "tax_exemption_id": null,
            "tax_exemption": null,
            "tax_exempt_reason": "",
            "is_available_products": true,
            "obs": ""
        },
        ...

    ]
}
```

{% endtab %}
{% endtabs %}

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