---
title: "Fetch User by id"
method: GET
path: "/v1/user/{distinct_id}/"
---

# Fetch User by id

`GET /v1/user/{distinct_id}/`

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

## Path parameters

- `distinct_id` string, required

## Response `200`

200

- object
  - `distinct_id` string — Unique identifier of the user.
  - `properties` object — all user properties in key-value pair. SuprSend reserved properties start with $
  - `created_at` string, date-time — Timestamp when the user was created.
  - `updated_at` string, date-time — Timestamp when the user was last updated.
  - `$<channel>` object[] — List of active communication channels for the user.
    - `value` string — channel value
    - `status` string — Current status of the channel (active or inactive).
    - `perma_status` string — active/disabled. Perma_status is marked disabled in case of hard bounce on the channel.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)