Customers API

List Customers

GET /api/v1/customers

Returns a paginated list of registered storefront customers.

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Items per page (1-200)
cursor	string	—	ISO timestamp for pagination
order	string	asc	Sort direction

Response

{
  "data": [
    {
      "id": "cust-uuid-1",
      "name": "Ahmed Mohamed",
      "phone": "+218912345678",
      "email": "ahmed@example.com",
      "city": "Tripoli",
      "is_active": true,
      "created_at": "2026-03-10T08:00:00Z",
      "last_modified": "2026-04-20T10:00:00Z"
    }
  ]
}

Get Single Customer

GET /api/v1/customers/:id

Mapping to Odoo

Tajir Field	Odoo Model	Odoo Field
name	res.partner	name
phone	res.partner	phone
email	res.partner	email
city	res.partner	city
id	res.partner	ref (external reference)