GET /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

See Pagination.

Returns a maximum of 100 records per page for cursor pagination.

Allowed For

Servers

Path parameters

Name Type Required Description
user_id Integer Yes

The id of the user

Query parameters

Name Type Required Description
page Object No

Cursor-based pagination parameters (JSON:API style).

Supports nested parameters:

  • page[size] - Number of records per page (default varies by endpoint, typically 100)
  • page[after] - Cursor token to fetch records after this position
  • page[before] - Cursor token to fetch records before this position

Example: ?page[size]=50&page[after]=eyJvIjoiaWQiLCJ2IjoiYVFFPSJ9

include_boundary_indicators Boolean No

When true, includes has_more indicator in the cursor pagination response meta.

Only valid with cursor pagination (page[size], page[after], page[before]).

sort String No

Field to sort results by. Prefix with - for descending order.

When used with cursor pagination, this determines the cursor ordering.

Example: ?sort=name or ?sort=-created_at

type[] Array No

Filters results by one or more identity types using the format ?type[]={type}&type[]={type}

include_item_cursors Boolean No

When true, includes cursor values for each item in the cursor pagination response.

Only valid with cursor pagination (page[size], page[after], page[before]).

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.