GET /customers/{id}

Updated Oct 1, 20261 minute read

Get a customer

The whole person: their history, the browser context the widget noticed, and the facts learned from resolved conversations.

Part of Customers.

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes	A customer id.

Status	Description
`200`	The customer.
`401`	The bearer token is missing, revoked, or expired.
`404`	Not one of yours, or not there at all.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`id`	`string`	No
`name`	`any`	No
`customerNumber`	`any`	No
`email`	`any`	No
`isVerified`	`boolean`	No	The host's site vouched for who this is.
`firstSeenAt`	`integer`	No
`lastSeenAt`	`any`	No
`conversationCount`	`integer`	No
`hasMoreConversations`	`boolean`	No
`metadata`	`object`	No
`context`	`object`	No	What the widget noticed about their browser, or null.
`context.timeZone`	`string`	No
`context.locale`	`string`	No
`context.browser`	`string`	No
`context.os`	`string`	No
`context.device`	`"desktop" \| "tablet" \| "mobile"`	No
`context.screen`	`string`	No
`conversations`	`object[]`	No
`conversations[].id`	`string`	No
`conversations[].threadId`	`any`	No
`conversations[].subject`	`string`	No
`conversations[].preview`	`string`	No
`conversations[].status`	`string`	No
`conversations[].aiStatus`	`string`	No
`conversations[].lastMessageAt`	`integer`	No
`facts`	`object[]`	No
`facts[].id`	`string`	No
`facts[].kind`	`"identity" \| "setup" \| "billing" \| "preference" \| "promise"`	No
`facts[].text`	`string`	No
`facts[].learnedAt`	`integer`	No

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