List Identities

GET {{baseUrl}}/api/v2/users/:user_id/identities

Returns a list of identities for the given user.

Use the first endpoint if authenticating as an agent. Use the second if authenticating as an end user. End users can only list email and phone number identities.

Pagination

  • Cursor pagination (recommended)
  • Offset pagination

See Pagination.

Returns a maximum of 100 records per page.

Allowed For

  • Agents
  • Verified end users

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"identities":[{"created_at":"2011-07-20T22:55:29Z","id":35436,"primary":true,"type":"email","updated_at":"2011-07-20T22:55:29Z","user_id":135,"value":"someone@example.com","verified":true},{"created_at":"2012-02-12T14:25:21Z","id":77136,"primary":false,"type":"twitter","updated_at":"2012-02-12T14:25:21Z","user_id":135,"value":"didgeridooboy","verified":true},{"created_at":"2012-02-12T14:25:21Z","id":88136,"primary":true,"type":"phone_number","updated_at":"2012-02-12T14:25:21Z","user_id":135,"value":"+1 555-123-4567","verified":true}]}