---
title: "Get user profile"
method: GET
path: "/{WSID}/{version}/profiles/{distinct_id}"
tags: ["Manage User Profiles"]
---

# Get user profile

`GET /{WSID}/{version}/profiles/{distinct_id}`

This API enables you to get an existing user profile.

## Path parameters

- `WSID` string, required
- `version` 'live' | 'test', required
- `distinct_id` string, required

## Response `200`

Profile fetched successfully

- object
  - `channel` InlineResponse200Channel, required
    - `discord` string — The discord ID of the user.
    - `email` string — The email address of the user.
    - `inapp` InlineResponse200ChannelInapp[]
      - `integration_id` string — The integration ID that was used to generate the above token. If this value is null, then the above token is used for all InApp integrations.<br/><br/>The integration ID can be verified from Fyno's integrations page.
      - `status` 1 | 0 — The status of the token. If `1`, the token is active and should receive notifications. If `0`, the token in inactive and should not receive notifications.
      - `token` string, required — Enter the distinct ID or the generated token of the user.
    - `push` InlineResponse200ChannelPush[]
      - `integration_id` string — The integration ID that was used to generate the above token. If this value is null, then the above token is used for all push integrations.<br/><br/>The integration ID can be verified from Fyno's integrations page.
      - `status` 1 | 0 — The status of the token. If `1`, the token is active and should receive notifications. If `0`, the token in inactive and should not receive notifications.
      - `token` string — The push token of the user.
    - `slack` string — The channel ID, user ID, or email address of the user.
    - `sms` string — The mobile number of the user.
    - `teams` string — The channel name.
    - `voice` string — The mobile number of the user.
    - `whatsapp` string — The WhatsApp mobile number of the user.
  - `country_code` string, required — The country code of the user. This value is automatically determined based on the number provided in the SMS channel of the profile. For a list of possible values, please <a href="https://fynodocs.s3.ap-south-1.amazonaws.com/files/country_code.json" target="_blank">click here</a>.
  - `created_at` string, required — The timestamp when the profile was created in ISO Date Time Format.
  - `distinct_id` string, required — The distinct ID used to identify the user.
  - `id_list` string[], required — Other profile IDs previously linked to this profile.
  - `name` string — The full name of the user.
  - `profile_id` string, required — Unique profile ID within Fyno.
  - `status` 1 | 0, required — The status of the user. If `1`, the user is active and should receive notifications. If `0`, the user in inactive and should not receive notifications.
  - `timezone` string, required — The timezone of the user. For a list of possible values, please <a href="https://fynodocs.s3.ap-south-1.amazonaws.com/files/timezones.json" target="_blank">click here</a>.
  - `timezone_offset` string, required — The timezone offset of the user. The value is automatically determined based on the timezone provided for the user in the profile.
  - `updated_at` string, required — The timestamp when the profile was last updated in ISO Date Time Format.
  - `version` 'live' | 'test', required — The version where the user profile is available.

## Other responses

- `400` — Distinct ID does not exist
- `401` — API Key or Workspace ID is invalid. User is unauthorised.

## Changes

- **2025-02-17** `ee2cf82f4e6a` — 16 info
  - the response property `_message` became required for the status `400`
  - the response property `_message` became required for the status `401`
  - the response property `channel` became required for the status `200`
  - the response property `channel/inapp/items/token` became required for the status `200`
  - …12 more

[Change history](https://skmtc.dev/fynoio/apis/fyno-rest-api/changes/:WSID/:version/profiles/:distinct_id/get.md)

---

[API](https://skmtc.dev/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.dev/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/revisions/ee2cf82f4e6a/schema)