> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenflow.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stock Movements

> Retrieve stock movement history

# Get Stock Movements

Retrieve the history of stock movements (additions, removals, transfers).

<Note>Requires `read:stock` scope.</Note>

## Request

```bash theme={null}
GET /api/v1/stock/movements
```

### Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Items per page (max 100)
</ParamField>

<ParamField query="product_id" type="integer">
  Filter by product ID
</ParamField>

<ParamField query="location_id" type="string">
  Filter by location ID
</ParamField>

<ParamField query="movement_type" type="string">
  Filter by movement type (IN, OUT, TRANSFER, ADJUSTMENT)
</ParamField>

<ParamField query="start_date" type="string">
  Filter from date (YYYY-MM-DD)
</ParamField>

<ParamField query="end_date" type="string">
  Filter to date (YYYY-MM-DD)
</ParamField>

## Example

```bash theme={null}
curl -X GET "https://api.zenflow.com.ar/api/v1/stock/movements?product_id=100&start_date=2024-01-01" \
  -H "X-API-Key: zenflow_live_your_key"
```

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "movements": [
      {
        "id": "MOV-12345",
        "product_id": 100,
        "product_name": "Widget A",
        "location_id": "LOC-A1",
        "movement_type": "IN",
        "quantity": 50,
        "previous_quantity": 25,
        "new_quantity": 75,
        "reason": "Stock replenishment",
        "user_id": 1,
        "created_at": "2024-01-14T10:30:00Z"
      },
      {
        "id": "MOV-12344",
        "product_id": 100,
        "product_name": "Widget A",
        "location_id": "LOC-A1",
        "movement_type": "OUT",
        "quantity": 5,
        "previous_quantity": 30,
        "new_quantity": 25,
        "reason": "Order fulfillment",
        "order_id": 12345,
        "created_at": "2024-01-13T15:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 150,
      "total_pages": 3
    }
  }
}
```

## Movement Types

| Type         | Description                      |
| ------------ | -------------------------------- |
| `IN`         | Stock added (receiving, returns) |
| `OUT`        | Stock removed (orders, damages)  |
| `TRANSFER`   | Stock moved between locations    |
| `ADJUSTMENT` | Inventory count correction       |