--- title: "Query Multiple Talents" method: POST path: "/v1/talents/multi-query" tags: ["Talent"] --- # Query Multiple Talents `POST /v1/talents/multi-query` ## Request - Base URL: `https://api.avionte.com/front-office` - URL: `https://api.avionte.com/front-office/v1/talents/multi-query` - Auth: one of: - API key in header `x-api-key` - HTTP bearer Returns details about the specified talent records. ## Headers - `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events. - `FrontOfficeTenantId` integer - `Tenant` string ## Request body - IntegerSchema[] ## Response `200` A list of talent records. - Talent[] - `id` integer: The identifier for the talent. - `firstName` string: The talent's first name. - `middleName` string: The talent's middle name. - `lastName` string: The talent's last name. - `homePhone` string: The talent's home phone. - `workPhone` string: The talent's work phone. - `mobilePhone` string: The talent's mobile phone. - `pagerNumber` string: The talent's pager number. - `emailAddress` string: The talent's email address. - `emailAddress2` string: The talent's second email address. - `taxIdNumber` string: The numeric digits for the talent's Taxpayer Identification Number. It may be either the US SSN or the Canadian SIN. If the Canadian SIN is less than 9 digits, then 0's will be prepended to the number to reach 9 digits. - `birthday` string, date-time: The talent's birthday. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2000-12-01 or 2000-12-01T00:00:00. - `gender` string: The talent's gender. Valid values are "M" or "Male", "F" or "Female", "N" or "Non-Binary", "X" or "I Do Not Wish To Answer". - `hireDate` string, date-time: The talent's date of hire with the staffing agency. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00. - `residentAddress` Address - `street1` string: Street address, line 1. - `street2` string: Street address, line 2. - `city` string: City. - `state_Province` string: ISO 2-character code for the Province, State, or Region. - `postalCode` string: ZIP/postal code. - `country` string: A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the General Guidelines. - `county` string: County. - `geoCode` string: Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address. - `schoolDistrictCode` string: School district code based on the Geo Code. - `mailingAddress` Address - `street1` string: Street address, line 1. - `street2` string: Street address, line 2. - `city` string: City. - `state_Province` string: ISO 2-character code for the Province, State, or Region. - `postalCode` string: ZIP/postal code. - `country` string: A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the General Guidelines. - `county` string: County. - `geoCode` string: Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address. - `schoolDistrictCode` string: School district code based on the Geo Code. - `payrollAddress` Address - `street1` string: Street address, line 1. - `street2` string: Street address, line 2. - `city` string: City. - `state_Province` string: ISO 2-character code for the Province, State, or Region. - `postalCode` string: ZIP/postal code. - `country` string: A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the General Guidelines. - `county` string: County. - `geoCode` string: Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address. - `schoolDistrictCode` string: School district code based on the Geo Code. - `addresses` Address[]: An address array containing only the talent's home address. - `street1` string: Street address, line 1. - `street2` string: Street address, line 2. - `city` string: City. - `state_Province` string: ISO 2-character code for the Province, State, or Region. - `postalCode` string: ZIP/postal code. - `country` string: A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the General Guidelines. - `county` string: County. - `geoCode` string: Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address. - `schoolDistrictCode` string: School district code based on the Geo Code. - `status` string: The talent's status. - `filingStatus` 'None' | 'Single' | 'Married' | 'MarriedWithHigherRate': Filing statuses available for selection for Form W-4. - `federalAllowances` integer: Federal withholding exemptions. - `stateAllowances` integer: State withholding exemptions. - `additionalFederalWithholding` number: Additional amount of money that is withheld from the talent's each paycheck based on the talent's request. - `i9ValidatedDate` string, date-time: The date the talent's I-9 document was verified. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00. - `frontOfficeId` integer: The identifier for the talent’s home office/branch. It occupies the following position in the Front Office hierarchy: Division > Region > Office/Branch. - `latestActivityDate` string, date-time: The date of the talent's latest activity. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. If the timestamp includes a Z (e.g., YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss.sssZ), it indicates UTC time. For example, 2024-12-01, 2024-12-01T14:30:00, 2024-12-01T14:30:00.546, 2024-12-01T14:30:00Z, and 2024-12-01T14:30:00.546Z. - `latestActivityName` string: The talent's latest activity type. - `link` string: URL to the talent profile. - `race` string: The talent's race. Valid values are American Indian or Alaska Native, Asian (Not Hispanic or Latino), Black or African American (Not Hispanic or Latino), Hispanic or Latino, Native Hawaiian or Other Pacific Islander, Two or More Races (Not Hispanic or Latino), White (Not Hispanic or Latino), I do not wish to answer. - `disability` string: The talent's disability status. Valid values are Individual with Disabilities Individual without Disabilities I do not wish to answer - `veteranStatus` string: The talent's veteran status. Valid values are Armed Forces Services Medal Veteran Disabled Veteran Non Veteran Other Protected Veteran Recently Separated Veteran Active Wartime or Campaign Badge Veteran I do not wish to answer - `emailOptOut` boolean: An indication of whether the talent has opted out of receiving emails from Avionté BOLD or not. - `isArchived` boolean: An indication of whether the talent record is archived or not. - `placementStatus` string: The talent's current placement status. Possible values are: "Active Contractor", "Permanently Placed", "Not Active Contractor". - `representativeUser` integer: The user ID of the representative who is working with the talent. - `w2Consent` boolean: An indication of whether the talent has consented to receive the W-2 form electronically or not. - `electronic1095CConsent` boolean: An indication of whether the talent has consented to receive the 1095-C form electronically or not. - `referredBy` string: A comma-delimited list of usernames who referred the talent, with each name followed by an indicator specifying the type of user (Applicant or Contact). - `availabilityDate` string, date-time: The date when the talent is available for work. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00. - `statusId` integer: The talent's status ID. - `officeName` string: The name of the talent's home office/branch. - `officeDivision` string: The division of the talent's home office/branch. - `enteredByUserId` integer: The ID of the user who entered the talent record. - `enteredByUser` string: The email of the user who entered the talent record. - `representativeUserEmail` string: The email of talent's representative user. - `createdDate` string, date-time: The date the talent profile was created. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546. - `lastUpdatedDate` string, date-time: The date of the most recent update to the talent profile. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546. - `latestWork` string: The most recent employment of the talent (company - position). - `lastContacted` string, date-time: The date the talent was last contacted via the Send Email option on their profile. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00. - `flag` string: An indication of whether the talent profile is flagged. If flagged, the value is specified as Green, Yellow or Red or "" for cases when an empty value is selected. - `origin` string: The partner or vendor that originated the request. "API" is appended by Avionté. - `originRecordId` string: The identifier for the talent that can be used to link the record within the originating system. - `electronic1099Consent` boolean: An indication of whether the talent has consented to the electronic delivery of forms or not. - `textConsent` string: The talent's consent status for receiving text messages. Acceptable Values are "Opt Out", "Opt In", and "No Response". - `talentResume` Resume - `resumeFilename` string: The file name for the resume that was uploaded. - `resumeText` string: Raw text of a resume if a file was not uploaded. - `resumeContents` string: The contents of the uploaded resume file passed as Base64 string content. Contents in this property will supersede any raw resume text that is passed in the ResumeText property. - `rehireDate` string, date-time: The talent's date of rehire with the staffing agency. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00. - `terminationDate` string, date-time: The talent's date of termination with the staffing agency. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00. - `employmentTypeId` integer: The identifier for the talent's employment type which can represent a custom W-2, 1099, or C2C value. - `employmentType` string: The type of employment associated to the talent's custom employment type value which can be either W-2, 1099, or C2C. - `employmentTypeName` string: The talent's custom employment type value. - `travelRadius` integer: The maximum distance in miles the talent is willing to travel for work. ## 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.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)