curl --request GET \
  --url https://{your-subdomain}.neetodesk.com/api/external/v2/customers \
  --header 'X-Api-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};

fetch('https://{your-subdomain}.neetodesk.com/api/external/v2/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetodesk.com/api/external/v2/customers"

headers = {"X-Api-Key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "customers": [
    {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00002222",
      "name": "John Doe",
      "email": "john@example.com",
      "language": "English",
      "time_zone": "Eastern Time (US & Canada)",
      "description": "VIP customer",
      "created_at": "2026-09-01T10:15:30.000Z",
      "updated_at": "2026-09-03T08:42:11.000Z",
      "emails": [
        "john@example.com",
        "john.doe@work.example.com"
      ],
      "phone_numbers": [
        "+1234567890"
      ],
      "company": {
        "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
        "name": "Acme Inc."
      }
    }
  ],
  "pagination": {
    "total_records": 95,
    "total_pages": 4,
    "current_page_number": 1,
    "page_size": 30
  }
}

{
  "error": "email must be a string"
}