Returns the company's production runs, from newest to oldest: by date, and within one date by number.

```
v1/production/get_list.php
```

## Parameters

| Field | Type | Required | Description |
|---|---|---|---|
| date_from | string | No | Production runs from this date inclusive, YYYY-MM-DD |
| date_to | string | No | Production runs up to this date inclusive, YYYY-MM-DD |
| status | int | No | Status code from [v1/production/get_statuses](https://developers.controlata.com/hc/api-docs/articles/api-production-get-statuses) |
| limit | int | No | Page size, from 1 to 1000 |
| offset | int | No | How many records to skip |

Without limit the whole list is returned. See [Common Rules](https://developers.controlata.com/hc/api-docs/articles/api-rules) for pagination.

## Response

An array production with the production's fields (without products and consumption, which are returned by [Retrieving a Production Run](https://developers.controlata.com/hc/api-docs/articles/api-production-get-entry)):

| Field | Type | Description |
|---|---|---|
| id | int | Production run ID |
| num | int | Number. Assigned automatically |
| name | string | Name |
| date | string | Production date, YYYY-MM-DD |
| status | int | Status code from [Production Statuses](https://developers.controlata.com/hc/api-docs/articles/api-production-get-statuses) |
| order_id | int | ID of the sale the production was created for. 0 if not linked to a sale |
| produce_subproducts | int | 1 if subassemblies are produced together with the products |
| materials_storage_id | int | Storage location materials are deducted from. 0 if chosen automatically |
| materials_storage_name | string | Materials storage location name |
| products_storage_id | int | Storage location the produced products are added to |
| products_storage_name | string | Produced products storage location name |
| subproducts_storage_id | int | Storage location used products are deducted from. 0 if chosen automatically |
| subproducts_storage_name | string | Used products storage location name |
| cost | float | Cost of the whole production run |
| price | float | Value of the produced products at their sale price |
| amount | float | Total quantity of products. null if the products have different units |
| lines | int | Number of product lines |
| notes | string | Notes |

The total field holds the total number of production runs matching the filters.

## Example request

```
{
    "date_from": "2026-10-01",
    "status": 0,
    "limit": 100,
    "offset": 0
}
```

## Example response

```
{
    "success": true,
    "production": [
        {
            "id": 39978,
            "num": 152,
            "name": "Batch of tables",
            "date": "2026-10-06",
            "status": 0,
            "order_id": 0,
            "produce_subproducts": 1,
            "materials_storage_id": 3998,
            "materials_storage_name": "Main",
            "products_storage_id": 4001,
            "products_storage_name": "Finished goods",
            "subproducts_storage_id": 0,
            "subproducts_storage_name": null,
            "cost": 184250,
            "price": 390000,
            "amount": 50,
            "lines": 2,
            "notes": ""
        }
    ],
    "total": 1
}
```

## Errors

| Error | Reason |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | Invalid date_from or date_to |
| Invalid status value. Must be a number | status is not a number |
| Invalid limit value. Must be between 1 and 1000 | Invalid limit |
| Offset requires limit | offset passed without limit |