List customers

get

https://api.duodeal.app/api/customers

Retrieves a paginated list of all customers (contacts).

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number for pagination (default: 1)
`limit`	integer	No	Number of items per page (default: 50)
`order`	string	No	Field to sort by (default: id)
`direction`	string	No	Sort direction: `asc` or `desc` (default: desc)

Response Fields

Field	Type	Description
`id`	integer	Customer unique identifier
`number`	string	Auto-generated customer reference number
`firstName`	string	Customer first name
`lastName`	string	Customer last name
`fullName`	string	Computed full name (firstName + lastName)
`email`	string	Customer email address
`phone`	string	Primary phone number
`civility`	string	Civility/title (Mr, Mrs, etc.)
`jobTitle`	string	Job title/position
`customerCompany`	object	Linked customer company (B2B)
`billingAddress`	object	Billing address
`deliveryAddress`	object	Delivery address if different
`differentDeliveryAddress`	boolean	Whether delivery address differs from billing
`customFields`	object	Custom field values
`archived`	boolean	Whether the customer is archived
`isDeletable`	boolean	Whether the customer can be deleted (no linked deals)
`createdAt`	datetime	Creation timestamp
`updatedAt`	datetime	Last update timestamp

Filtering

This endpoint supports advanced filtering. See the Filter System Documentation for the complete list of operators and usage examples.

Quick examples:

?filters[firstName][contains]=John
?filters[email][endsWith][email protected]
?filters[customerCompany.name][contains]=Acme
?filters[customFields.source][eq]=website

Response

200 OK: Returns paginated list of customers
401 Unauthorized: Invalid or missing API key

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200

Successful response

401

Unauthorized

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here!