Get a User Identity

Get a specified user identity

Returns a specified user identity.

/user_identities/get

post

Returns a specified user identity.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session_with_customer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

or

Responses

200

OK

application/json

okbooleanRequired

400

Bad Request

401

Unauthorized

post

/user_identities/get

HTTPcURLJavaScriptPython

POST /user_identities/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "user_identity_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "user_identity": {
    "user_identity_id": "123e4567-e89b-12d3-a456-426614174000",
    "user_identity_key": "text",
    "email_address": "[email protected]",
    "phone_number": "text",
    "display_name": "text",
    "full_name": "text",
    "created_at": "2026-02-22T06:50:02.864Z",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "errors": [
      {
        "created_at": "2026-02-22T06:50:02.864Z",
        "message": "text",
        "error_code": "issue_with_acs_user",
        "acs_user_id": "123e4567-e89b-12d3-a456-426614174000",
        "acs_system_id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "warnings": [
      {
        "created_at": "2026-02-22T06:50:02.864Z",
        "message": "text",
        "warning_code": "being_deleted"
      }
    ],
    "acs_user_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  },
  "ok": true
}

Request

Specify the desired user identity by including the corresponding user_identity_id in the request body.

Request Body Parameters

Parameter	Type	Description
user_identity_id	String Required	ID of the desired user identity

Sample Request

cURL (bash)

# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/user_identities/get' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_identity_id": "48500a8e-5e7e-4bde-b7e5-0be97cae5d7a"
}'

Go

Response

Returns a user_identity containing the following properties:

Property	Description
user_identity_id	ID of the user identity
user_identity_key	Unique key for the user identity
email_address	Unique email address for the user identity
phone_number	Unique phone number for the user identity in E.164 format (for example, [phone])
display_name	Display name for the user identity
full_name	Full name of the user associated with the user identity
created_at	Date and time at which the user identity was created
workspace_id	ID of the workspace that contains the user identity

This response also includes a Boolean ok status indicator.

Sample Response

JSON

{
  "user_identity": {
    "user_identity_id": "48500a8e-5e7e-4bde-b7e5-0be97cae5d7a",
    "user_identity_key": "jean_doe",
    "email_address": "[email protected]",
    "phone_number": "[phone]",
    "display_name": "Jean Doe",
    "full_name": "Jean Doe",
    "created_at": "2024-01-11T05:37:50.264Z",
    "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be"
  },
  "ok": true
}