Retrieving a List of Suppliers | Controlata API Documentation

Returns the company's suppliers, sorted by name. Deleted suppliers are not included.

v1/suppliers/get_list.php

Parameters

Field	Type	Required	Description
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 suppliers with the supplier's fields. The total field holds the total number of suppliers.

Field	Type	Description
id	int	Supplier ID
name	string	Name
email	string	Email
phone	string	Phone
address	string	Address
agreement	string	Agreement
manager_name	string	Manager
manager_post	string	Manager's position
notes	string	Notes

Example request

{
    "limit": 100,
    "offset": 0
}

Example response

{
    "success": true,
    "suppliers": [
        {
            "id": 46,
            "name": "Hardware Supplies",
            "email": "hardware@example.com",
            "phone": "+1 312 555-0170",
            "address": "14 Peace St, Chicago",
            "agreement": "",
            "manager_name": "",
            "manager_post": "",
            "notes": ""
        },
        {
            "id": 45,
            "name": "Woodtrade Ltd",
            "email": "wholesale@woodtrade.com",
            "phone": "+1 646 555-0188",
            "address": "8 Harbor St, Boston",
            "agreement": "No. 7 of 15 Feb 2026",
            "manager_name": "Oleg Baker",
            "manager_post": "Director",
            "notes": "Delivery on Tuesdays"
        }
    ],
    "total": 2
}

Errors

Error	Reason
Invalid limit value. Must be between 1 and 1000	Invalid limit
Invalid offset value. Must be 0 or greater	Invalid offset
Offset requires limit	offset passed without limit