Skip to main content
GET
/
api
/
external
/
customers
List Customers
curl --request GET \
  --url https://api.example.com/api/external/customers
{
  "customers": [
    {
      "id": "<string>",
      "name": "<string>",
      "externalId": "<string>",
      "accountManager": "<string>",
      "lastSaved": "<string>"
    }
  ],
  "count": 123
}
Returns all customers for your MSP. Use this to get customer IDs for other endpoints.

​
Request

curl -X GET "https://dashboard.sphud.com/api/external/customers" \
  -H "X-API-Key: sphud_abc12345_xxxxxxxxxxxxxxxxxxxxxxxx"

​
Response

​
customers
array
Array of customer objects
​
count
number
Total number of customers returned

​
Response Example

{
  "customers": [
    {
      "id": "cust-uuid-1234",
      "name": "Acme Corp",
      "externalId": "ext-cust-999",
      "accountManager": "John Smith",
      "lastSaved": "2026-01-15"
    },
    {
      "id": "cust-uuid-5678",
      "name": "TechCo Industries",
      "externalId": "ext-cust-888",
      "accountManager": "Jane Doe",
      "lastSaved": "2026-01-20"
    }
  ],
  "count": 2
}
Save the customer id values - you’ll need them to import users and devices for specific customers.