---
title: "Get User by ID with Expanded References"
method: GET
path: "/users/{user_id}?expand=1"
tags: ["Users"]
---

# Get User by ID with Expanded References

`GET /users/{user_id}?expand=1`

## Request

- Base URL: `https://dataops.nexla.io/nexla-api`
- URL: `https://dataops.nexla.io/nexla-api/users/{user_id}?expand=1`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nexla/apis/nexla-rest-api/docs/users/:user_id%3Fexpand=1/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a user if a valid ID is provided.

## Path parameters

- `user_id` integer, required

## Query parameters

- `expand` union, required
  - integer
  - boolean

## Response `200`

Success

- UserExpanded
  - `id` integer
  - `email` string, email
  - `full_name` string
  - `super_user` boolean
  - `impersonated` boolean
  - `default_org` object
    - `id` integer
    - `name` string
  - `user_tier` 'FREE' | 'TRIAL' | 'PAID' | 'FREE_FOREVER': Indicates whether a user is on a paid, free, or trial account. Used to determine limits on records processed by the account.
  - `status` 'ACTIVE' | 'DEACTIVATED' | 'SOURCE_COUNT_CAPPED' | 'SOURCE_DATA_CAPPED' | 'TRIAL_EXPIRED': Indicates the user's account status across all organizations they are members of.
  - `account_locked` boolean
  - `org_memberships` OrgMembership[]
    - `id` integer
    - `name` string
    - `is_admin?` boolean
    - `org_membership_status` 'ACTIVE' | 'DEACTIVATED': Indicates whether the user's membership in this organization is active or not. If the membership is DEACTIVATED the user can no longer access the account but the resources owned by them will still be accessible by the organization administrators.
  - `email_verified_at` string, date-time
  - `tos_signed_at` string, date-time
  - `updated_at` string, date-time
  - `created_at` string, date-time
  - `account_summary` AccountSummary
    - `data_sources` object
      - `counts` object
        - `total` integer
        - `owner` integer
        - `collaborator` integer
        - `active` integer
        - `paused` integer
        - `draft` integer
    - `data_sets` object
      - `counts` object
        - `total` integer
        - `owner` integer
        - `collaborator` integer
        - `active` integer
        - `paused` integer
        - `draft` integer
    - `data_sinks` object
      - `counts` object
        - `total` integer
        - `owner` integer
        - `collaborator` integer
        - `active` integer
        - `paused` integer
        - `draft` integer
    - `data_maps` object
      - `counts` object
        - `total` integer
        - `owner` integer
        - `collaborator` integer

## Other responses

- `403`: Forbidden

---

[API](https://skmtc.dev/nexla/apis/nexla-rest-api.md) - [All operations](https://skmtc.dev/nexla/apis/nexla-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nexla/apis/nexla-rest-api/revisions/ef02be92fe7b?raw)
