---
title: "Retrieve a user"
method: GET
path: "/scim/v2/Users/{id}"
tags: ["SCIM"]
---

# Retrieve a user

`GET /scim/v2/Users/{id}`

Retrieves a single user resource.
The value of the <id> should be the user's corresponding user ID.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string

## Response `200`

OK

- object
  - `schemas` string[] — A list of schema URNs that define the structure and attributes of the user resource.
  - `id` string — The unique identifier for the user resource.
  - `meta` object
    - `created` string, date-time — The date and time when the user resource was created.
    - `resourceType` string — The type of resource (e.g., 'User').
    - `location` string — The URL where the user resource can be accessed or retrieved.
  - `userName` string — The user’s unique username.
  - `name` object
    - `formatted` string — The full name of the user, including both given and family names.
    - `familyName` string — The family name (surname) of the user.
    - `givenName` string — The given name (first name) of the user.
  - `displayName` string — The display name of the user, used for user interface purposes.
  - `preferredLanguage` string — The preferred language for the user, specified using a language code (e.g., 'en').
  - `locale` string — The locale of the user, specified using a locale code (e.g., 'en-US').
  - `active` boolean — Indicates whether the user account is active.
  - `emails` object[]
    - `value` string — The email address of the user.
    - `display` string — The email address displayed in the user interface.
    - `type` string — The type of email address (e.g., 'work', 'home').
    - `primary` boolean — Indicates whether this email address is the primary email for the user.
  - `groups` object[]
    - `value` string — The identifier of the group to which the user belongs.
    - `display` string — The display name of the group.
  - `roles` object[]
    - `value` string — The role assigned to the user.
    - `display` string — The display name of the role.
  - `urn:zuora:scim:schemas:1.0:UserExtension` object
    - `schemas` string[] — A list of schema URNs specific to Zuora’s user extension schema.
    - `organizationId` string — The identifier for the organization to which the user belongs.
    - `status` string — The status of the user account (e.g., 'ACTIVE').
    - `ssoEnabled` boolean — Indicates whether Single Sign-On (SSO) is enabled for the user.
    - `region` string — The region associated with the user (e.g., 'EU').

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/702f3caf3985/schema)