---
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`

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 UUID.
    - `branchGuid` string, uuid — The unique identifier for the Branch associated with the Talent, formatted as a UUID.
    - `backOfficeEmployeeId` integer — The identifier for the Talent 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 UUID.
      - `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, 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.
    - `dateOfBirth` string, 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.
    - `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, nullable — The identifier for the talent's check delivery option.

## 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.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)