---
title: "Query Multiple Talent by TalentGuids"
method: POST
path: "/v1/talent/multi-query"
tags: ["Talent"]
---

# Query Multiple Talent by TalentGuids

`POST /v1/talent/multi-query`

## Request

- Base URL: `https://api.avionte.com/back-office`
- URL: `https://api.avionte.com/back-office/v1/talent/multi-query`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Retrieves details about the specified talent records.

## Headers

- `FrontOfficeTenantId` integer, required
- `RequestId` string, uuid, required

## Request body

- string[]

## Response `200`

OK

- TalentMultiQuerySuccess
  - `totalRequestedCount` integer: Number of records request by multi-query request.
  - `foundCount` integer: Number of successfully retrieved entity records.
  - `errorCount` integer: Number of requested records where the entity record could not be returned.
  - `successItems` Talent[]: List of retrieved entity records.
    - `talentGuid` string, uuid, required: The unique identifier for the talent, formatted as a GUID.
    - `branchGuid` string, uuid: The unique identifier for the branch associated with the talent, formatted as a GUID.
    - `backOfficeEmployeeId` integer: The ID of the employee in the Back Office.
    - `firstName` string, required: The first name of the talent.
    - `middleName` string: The middle name of the talent.
    - `lastName` string, required: The last name of the talent.
    - `residentAddress` TalentAddress
      - `addressGuid` string, uuid, required: The unique identifier for the address, formatted as a GUID.
      - `street1` string: The primary street address.
      - `street2` string: An additional street address.
      - `city` string: The city of the address.
      - `postalCode` string: The postal code associated with the address.
      - `state` string: The state associated with the address.
      - `country` string, required: The country associated with the address.
    - `taxIdNumber` string: National identification number used for federal taxes. For talent with resident address in the USA or Canada, this value can be provided as digits only or in the format 111-111-1111 and must be valid for the country of residence to be saved.
    - `dateOfBirth` string, date-time: The date of birth of the talent.
    - `mobilePhone` string: The primary mobile phone number of the talent, chosen from the Cell field. If multiple entries exist, the most recent one is selected.
    - `emailAddress` string: 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.
    - `checkDeliveryOptionId` integer: The identifier for the check delivery option of the talent.

## Other responses

- `207`: Partial Success
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `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

---

[API](https://skmtc.dev/avionte/apis/aviont-back-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/aviont-back-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/aviont-back-office-api/revisions/175a738cecd0?raw)