Retrieving a List of Production Runs | Controlata API Documentation

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
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 for pagination.

Response

An array production with the production's fields (without products and consumption, which are returned by Retrieving a Production Run):

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
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