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

# Get - por Armazém

##  Obter Stock Geral de Produto

## Fornece uma Lista mais detalhada da distribuição do Stock pelos diferentes armazéns de um Produto a partir do seu :id.

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

#### Path Parameters

| Name                                 | Type    | Description                   |
| ------------------------------------ | ------- | ----------------------------- |
| id<mark style="color:red;">\*</mark> | integer | O ID do produto que pretende. |

#### Query Parameters

| Name             | Type    | Description                                                                                                                                                                                   |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| limit            | integer | Define o número de stock por armazém por pesquisa.                                                                                                                                            |
| offset           | integer | <p>Indica a posição inicial da pesquisa. </p><p></p><p>Retorna a lista de stock por armazém compreendida entre offset:offset+limit.</p>                                                       |
| ordering         | string  | <p>Define o campo e a direcção a usar na pesquisa de stock por armazém. </p><p></p><p>Para ordenar de forma descendente, deve usar o sinal de '-' antes do campo.</p>                         |
| in\_stock        | boolean | <p>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.<br>Por defeito: <code>null</code></p>     |
| with\_movements  | boolean | <p>Se <code>true</code>, serão devolvidos apenas stocks que tenham movimentos.<br>Se <code>false</code>, serão devolvidos apenas stocks sem movimentos.<br>Por defeito: <code>null</code></p> |
| movements\_since | string  | <p>Definir o limite MÍNIMO do intervalo de movimentos de stock a considerar.<br></p><p>Formato: <code>YYYY-MM-DD</code> ou <code>YYYY-MM-DDThh:mm</code></p>                                  |
| movements\_until | string  | <p>Definir o limite MÁXIMO do intervalo de movimentos de stock a considerar.<br></p><p>Formato: <code>YYYY-MM-DD</code> ou <code>YYYY-MM-DDThh:mm</code></p>                                  |

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

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

{% endtab %}

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

```json
{
    "limit": 10,
    "offset": 0,
    "count": 37,
    "next": "https://api.cloudinvoice.net/products/1/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)