GET /customers

Updated Oct 1, 20261 minute read

List customers

The directory, most recently heard from first. One row per person rather than per browser: visitors sharing an email fold into a single customer.

Part of Customers.

Parameters

Name	In	Type	Required	Description
`limit`	query	`integer`	No	Up to 100. Default 50.

Status	Description
`200`	The customers.
`401`	The bearer token is missing, revoked, or expired.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`customers`	`object[]`	No
`customers[].id`	`string`	No
`customers[].name`	`any`	No
`customers[].customerNumber`	`any`	No
`customers[].email`	`any`	No
`customers[].isVerified`	`boolean`	No	The host's site vouched for who this is.
`customers[].firstSeenAt`	`integer`	No
`customers[].lastSeenAt`	`any`	No
`customers[].conversationCount`	`integer`	No
`customers[].hasMoreConversations`	`boolean`	No

curl https://api.median.sh/v1/customers \
  -H "Authorization: Bearer $BEARER_AUTH"