> 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/produtos/precos-de-venda/list.md).

# List

Fornece uma lista de preços de venda dos produtos.

## Lista dos Stocks Gerais dos Produtos

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

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

#### Path Parameters

| Name     | Type    | Description   |
| -------- | ------- | ------------- |
| prod\_id | integer | ID do Produto |

#### 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> |
| price\_line | integer | ID da Linha de Preços                                                                                                                              |

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

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

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 28,
    "next": "https://api.cloudinvoice.net/products/prices/?limit=10&offset=10",
    "previous": null
    "results": [
        {
            "product_id": 1,
            "product": {
                "code": "PROD1",
                "description": "Produto Standard 1"
            },
            "price_line_id": 1,
            "price_line": {
                "code": 1,
                "description": "Preço de Venda 1"
            },
            "unit_price": 100.0,
            "unit_price_tax_inc": 123.0,
            "use_price_tax_inc": true,
            "tax_id": 1,
            "tax": {
                "code": 1,
                "description": "Taxa Normal",
                "tax_rate": 23.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 %}