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.

GET/customers

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Query parameters

limitinteger

Up to 100. Default 50.

Responses

200The customers.

customersCustomerSummary[]

Show properties

Array of CustomerSummary

idstring

namestring | null

customerNumberinteger | null

emailstring | null

isVerifiedboolean

The host's site vouched for who this is.

firstSeenAtinteger

lastSeenAtinteger | null

conversationCountinteger

hasMoreConversationsboolean

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/customers" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/customers", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "customers": [
    {
      "id": "string",
      "name": "string",
      "customerNumber": 0,
      "email": "string",
      "isVerified": true,
      "firstSeenAt": 0,
      "lastSeenAt": 0,
      "conversationCount": 0,
      "hasMoreConversations": true
    }
  ]
}