a686fddb4e0c

OpenAPI 3.1.12026-08-10130601.0 MB

Fetch User by id

API to fetch user object by passing it's unique distinct_id.

get/v1/user/{distinct_id}/

Path parameters

distinct_idstring required

Unique identifier of the user in your system

Response

200

distinct_idstring

Unique identifier of the user.

propertiesobject

all user properties in key-value pair. SuprSend reserved properties start with $

created_atstring date-time

Timestamp when the user was created.

updated_atstring date-time

Timestamp when the user was last updated.

Example response

{
  "distinct_id": "_distinct_id_",
  "created_at": "2025-04-04T09:55:12.397Z",
  "updated_at": "2025-04-04T09:55:12.422Z",
  "$<channel>": [
    {
      "status": "active"
    }
  ]
}