Skip to main content
GET
/
users
/
{userId}
/
aliases
Retrieve user identities
curl --request GET \
  --url https://api.permutive.app/v2.0/users/{userId}/aliases \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "user@example.com",
    "tag": "email",
    "permutive_id": "2008c38f-dece-4570-976d-87593ed001c3"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.permutive.com/llms.txt

Use this file to discover all available pages before exploring further.

Private API key required: You must provide a private API key during authentication to retrieve aliases.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
userId
string<uuid>
required

The Permutive user ID of the user to retrieve identities for.

Example:

"2008c38f-dece-4570-976d-87593ed001c3"

Response

List of resolved identities

​
id
string

The identity value.

​
tag
string

The identity tag/type.

​
permutive_id
string<uuid>

The resolved Permutive user ID.