Search customers

Find customers by name, email or phone.

GET https://cotlet.dev/api/v1/simpro/customers/search

read

Returns matching company and individual customers with ID, name and the sites on record, best match first. Pages through the result. A customer is found only if it exists in your Simpro build. Your Simpro permissions decide which customers appear.

Parameters

Parameters: search_customers
NameTypeDescription
query string required string Name, email address or phone number.
page integer integer Page number, starting at 1.

Request

cURL
curl "https://cotlet.dev/api/v1/simpro/customers/search?query=query" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("simpro", "search_customers", {"query":"query"})
Node.js
const result = await cotlet.call('simpro', 'search_customers', {"query":"query"});
CLI
cotlet call simpro search_customers --data '{"query":"query"}'

Example response

JSON

{
  "results": [
    {
      "customer_id": 3318,
      "type": "company",
      "name": "Harbour Dental",
      "sites": [
        {
          "site_id": 5107,
          "name": "12 Pier Rd"
        }
      ]
    }
  ],
  "page": 1,
  "has_more": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.