---
title: "GET /users.identity"
method: GET
path: "/users.identity"
tags: ["users"]
---

# GET /users.identity

`GET /users.identity`

Get a user's identity.

## Query parameters

- `token` string

## Response `200`

You will receive at a minimum the following information:

- union[] — Schema for successful response from users.identity method
  - union
    - object — Schema for 'identity.basic' scope
      - `ok` true, required
      - `team` object, required
        - `id` string, required
      - `user` object, required
        - `id` string, required
        - `name` string, required
    - object — Schema for 'identity.basic,identity.email' scopes
      - `ok` true, required
      - `team` object, required
        - `id` string, required
      - `user` object, required
        - `email` string, email, required
        - `id` string, required
        - `name` string, required
    - object — Schema for 'identity.basic,identity.avatar' scopes
      - `ok` true, required
      - `team` object, required
        - `id` string, required
      - `user` object, required
        - `id` string, required
        - `image_192` string, url, required
        - `image_24` string, url, required
        - `image_32` string, url, required
        - `image_48` string, url, required
        - `image_512` string, url, required
        - `image_72` string, url, required
        - `name` string, required
    - object — Schema for 'identity.basic,identity.team' scopes
      - `ok` true, required
      - `team` object, required
        - `domain` string, required
        - `id` string, required
        - `image_102` string, url, required
        - `image_132` string, url, required
        - `image_230` string, url, required
        - `image_34` string, url, required
        - `image_44` string, url, required
        - `image_68` string, url, required
        - `image_88` string, url, required
        - `image_default` boolean, required
        - `name` string, required
      - `user` object, required
        - `id` string, required
        - `name` string, required

## Other responses

- `default` — Typical error response

---

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