Retrieving a Customer | Controlata API Documentation

Returns a customer's details.

v1/customers/get_entry.php

Parameters

Field	Type	Required	Description
customer_id	int	Yes	Customer ID

A deleted customer is not returned.

Response

An object customer with the customer's fields. The fields from the response can be sent to v1/customers/edit unchanged, adding customer_id.

Field	Type	Description
id	int	Customer ID
name	string	Name
email	string	Email
phone	string	Phone
address_legal	string	Legal address
address_real	string	Delivery address
agreement	string	Agreement
manager_name	string	Manager
manager_post	string	Manager's position
notes	string	Notes

Customer files are neither sent nor returned via the API.

Example request

{
    "customer_id": 512
}

Example response

{
    "success": true,
    "customer": {
        "id": 512,
        "name": "Furniture Yard",
        "email": "orders@furnitureyard.com",
        "phone": "+1 212 555-0123",
        "address_legal": "5 Forest St, New York",
        "address_real": "12 Warehouse Rd, New York",
        "agreement": "No. 15 of 10 Jan 2026",
        "manager_name": "Peter Johnson",
        "manager_post": "CEO",
        "notes": ""
    }
}

Errors

Error	Reason
No customer_id in input	customer_id is missing
Customer not found or access denied	Customer not found or deleted