---
title: "Get a Talent User by ID"
method: GET
path: "/v1/user/{userId}"
tags: ["Users"]
---

# Get a Talent User by ID

`GET /v1/user/{userId}`

Returns details about the specified talent user.

## Path parameters

- `userId` string, required

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Response `200`

The talent user record.

- ApiUser
  - `userId` integer — The identifier for the user.
  - `firstName` string — The user's first name.
  - `lastName` string — The user's last name.
  - `emailAddress` string — The user's email address.
  - `homePhone` string — The user's home phone number.
  - `workPhone` string — The user's work phone number.
  - `mobilePhone` string — The user's mobile phone number.
  - `faxPhone` string — The user's fax phone number.
  - `address` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `officeName` string — The name of the user's home office.
  - `officeDivision` string — The division of the user's home office.
  - `officeRegion` string — The region of the user's home office.
  - `isArchived` boolean — An indication of whether the user's record is archived or not.
  - `createdDate` string, date-time — The date when the user profile was created.
  - `lastUpdatedDate` string, date-time — The date of the most recent update to the user profile.
  - `smsPhoneNumber` string — The phone number to which SMS messages should be sent.
  - `smsForwardingNumber` string — The phone number to which SMS messages should be forwarded.
  - `userType` string — User type of the user
  - `entityId` integer — The ID of the entity associated with the user. When User Type = HCM, it is the ID of the user When User Type = Manager or Contractor, it is the ID of that entity
  - `email2` string — The second email of the user.
  - `status` 'Inactive' | 'Active'
  - `homeOfficeId` integer — The identifier of the user's home office.
  - `officeAccess` integer[] — A list of office IDs that the user has access to.
  - `userGroups` integer[] — A list of user group IDs to which the user belongs.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/versions/846b33e4e71b/schema)