v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Get a Talent

Returns details about the specified talent record.

get/v1/talent/{talentId}

Path parameters

talentIdstring required

The identifier for the talent whose details are being retrieved.

Query parameters

includeResumestring

An indication of whether the resume should be retrieved as part of the request or not. Set this URL parameter to 'True' to retrieve the resume or 'False' to omit it.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Response

The requested talent record.

talentGuidstring uuid required

The unique identifier for the Talent, formatted as a UUID.

branchGuidstring uuid

The unique identifier for the Branch associated with the Talent, formatted as a UUID.

backOfficeEmployeeIdinteger

The identifier for the Talent in the Back Office.

firstNamestring required

The first name of the talent.

middleNamestring

The middle name of the talent.

lastNamestring required

The last name of the talent.

taxIdNumberstring nullable

The national identification number used for federal taxes. For talent with resident address in the U.S. or Canada, this value may be provided as digits only or in the format 111-111-1111 and must be valid for the country of residence to be saved.

dateOfBirthstring date-time nullable

The date of birth of the talent. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z.

mobilePhonestring

The primary mobile phone number of the talent, chosen from the Cell field. If multiple entries exist, the most recent one is selected.

emailAddressstring

The primary email address of the talent, chosen from the Email field. If multiple entries exist, the most recent one is selected.

gender'UNKNOWN' | 'M' | 'F' | 'N' | 'X'

Gender.

checkDeliveryOptionIdinteger nullable

The identifier for the talent's check delivery option.