> 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/stock/list-por-armazem.md).

# List - por Armazém

Fornece uma lista mais detalhada da distribuição do stock dos produtos pelos diferentes armazéns.

## Listar Stocks dos Produtos por Armazém

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

#### 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>in_stock</td><td>boolean<br><sub><mark style="color:$info;">Default: null</mark></sub></td><td>Se <code>true</code>, serão devolvidos apenas stocks positivos.<br>Se <code>false</code>, serão devolvidos apenas os stocks a zero ou negativos.</td></tr><tr><td>with_movements</td><td>boolean<br><sub><mark style="color:$info;">Default: null</mark></sub></td><td>Se <code>true</code>, serão devolvidos apenas stocks que tenham movimentos.<br>Se <code>false</code>, serão devolvidos apenas stocks sem movimentos.</td></tr><tr><td>movements_since</td><td>date<br><sub><mark style="color:$info;">Format: YYYY-MM-DD</mark></sub><br>              <sub><mark style="color:$info;">YYYY-MM-DDThh:mm</mark></sub></td><td>Limite mínimo do intervalo de movimentos de stock a considerar</td></tr><tr><td>movements_until</td><td>date<br><sub><mark style="color:$info;">Format: YYYY-MM-DD</mark></sub><br>              <sub><mark style="color:$info;">YYYY-MM-DDThh:mm</mark></sub></td><td>Limite máximo do intervalo de movimentos de stock a considerar.</td></tr></tbody></table>

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

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

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 46,
    "next": "https://api.cloudinvoice.net/products/stocks_per_warehouse/?limit=10&offset=10",
    "previous": null,
    "results": [
        {
            "product_id": 1,
            "warehouse_id": 1,
            "location_id": 1,
            "physical_qty": 7.0,
            "cust_ordered_qty": 0.0,
            "available_qty": 7.0
        },
        {
            "product_id": 1,
            "warehouse_id": 2,
            "location_id": 2,
            "physical_qty": 3.0,
            "cust_ordered_qty": 1.0,
            "available_qty": 2.0
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

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