Customers and suppliers
List and retrieve counterparties with contact, address, status, currency, and tags.
Customers and suppliers share a response shape but use distinct permissions and routes.
| Resource | List | Retrieve | Permission |
|---|---|---|---|
| Customers | GET /customers | GET /customers/{id} | לקוחות (customers:read) |
| Suppliers | GET /suppliers | GET /suppliers/{id} | ספקים (suppliers:read) |
List parameters
Both lists support limit, cursor, created_after, updated_after, status=active|inactive, and search. Search covers name, business number, email, and contact person. Results sort by updated_at descending and then ID descending.
set -euo pipefail
: "${DAILY_API_KEY:?DAILY_API_KEY is required}"
curl --fail-with-body --silent --show-error --get \
'https://api.godaily.co.il/v1/customers' \
--header "Authorization: Bearer ${DAILY_API_KEY}" \
--header 'Accept: application/json' \
--data-urlencode 'status=active' \
--data-urlencode 'search=Orion' \
--data-urlencode 'limit=50'Customer response
{
"data": [{
"id": "44f34dad-a427-4c65-ae26-b0a43f8f65f7",
"object": "customer",
"type": "customer",
"name": "Orion Retail",
"business_number": "515880391",
"contact_person": "Noa Levi",
"email": "billing@orion-retail.test",
"additional_emails": ["ops@orion-retail.test"],
"phone": "+972-52-555-0128",
"phones": [{ "value": "+972-52-555-0128", "primary": true }],
"address": { "street": "HaArba’a", "street_number": "28", "city": "Tel Aviv-Yafo", "postal_code": "6473925", "country_code": "IL" },
"status": "active",
"currency": "ILS",
"tags": ["retail", "priority"],
"created_at": "2025-06-17T09:20:00.000Z",
"updated_at": "2026-07-19T14:12:00.000Z"
}],
"page": { "has_more": false, "next_cursor": null },
"request_id": "req_docscustomer01"
}The first ordered phone is also exposed as phone. additional_emails excludes the primary email. Address and contact fields may be null; arrays remain present.
Detail operations accept only a UUID path parameter. Missing and out-of-scope IDs return 404 resource_not_found; invalid UUIDs return 400 invalid_filter.
API playground
Your key stays only in this React page’s memory and is sent directly to Daily API. It is not persisted, placed in a URL, logged, or sent to analytics. Refreshing or closing this page clears it.
https://api.godaily.co.il/v1/customers
