---
title: "Get a single User"
method: GET
path: "/v2/users/{userId}"
tags: ["Users"]
---

# Get a single User

`GET /v2/users/{userId}`

| ⚠️  This endpoint is currently in BETA |
|--|

Returns information about a single internal User, including name, primary email
address, all email addresses, photo URL, account status, and account role.

The `userId` path parameter is the same identifier as the User's corresponding Person ID —
every internal User has a matching Person record, and they share the same numeric ID. You can
use a Person ID returned from any Persons endpoint here, and vice versa.

The `emailAddresses` and `role` properties are only returned to callers with the "Manage
Users" [permission](/pages/external-api-v2/permissions).

## Path parameters

- `userId` integer, required

## Response `200`

OK

- UserData — An internal user in your organization, including their name, primary email address, all email addresses, photo URL, account status, and account role.
  - `id` integer, required — The user's unique identifier
  - `firstName` string, required — The user's first name
  - `lastName` string, nullable, required — The user's last name
  - `primaryEmailAddress` string, email, nullable, required — The user's primary email address
  - `emailAddresses` string[] — All of the user's email addresses. Only returned when the authenticated user has the "Manage Users" [permission](/pages/external-api-v2/permissions).
  - `photoUrl` string, uri, nullable, required — URL of the user's profile photo
  - `status` 'active' | 'invited' | 'deactivated', required — The user's account status. - `active`: the user can sign in and use Affinity. - `invited`: the user has been invited to the product but has not yet accepted the invitation and thus cannot have taken any actions. - `deactivated`: the user was once active but has been deactivated and can no longer use the product.
  - `role` string — The user's account role. Only returned when the authenticated user has the "Manage Users" [permission](/pages/external-api-v2/permissions).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)