---
title: "Get Company Restrictions by Talent IDs"
method: POST
path: "/v1/company-restrictions/multi-talents/multi-query"
tags: ["Companies"]
---

# Get Company Restrictions by Talent IDs

`POST /v1/company-restrictions/multi-talents/multi-query`

## Request

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

Returns a list of companies where the specified talents are blocked from placement.

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

The list of companies where the specified talents are blocked from placement.

- CompanyRestriction[]
  - `id` integer: The identifier for the company restriction.
  - `companyId` integer: The identifier for the company the restriction applies to.
  - `branchIds` string: The string representation of the array of identifiers for the departments the restriction applies to.
  - `talentName` string: The name of the talent who has been restricted from placement.
  - `notes` string: Notes on the restriction.
  - `userId` integer: The identifier for the user who has added the restriction.
  - `userName` string: The name of the user who has added a restriction.
  - `companyName` string: The name of the company the restriction applies to.
  - `talentId` integer: The identifier for the talent who is blocked from placement at the selected company or office.
  - `departments` Department[]: The departments where the talent is blocked from placement and their details.
    - `id` integer: The identifier for the department.
    - `name` string: The name of the department.
    - `companyId` integer: The identifier for the company.
    - `officeId` integer: The identifier for the office.
    - `statusId` integer: The identifier for the status.
    - `status` string: The status value.
    - `statusType` string: The status type value.
    - `parentDepartmentId` integer: The identifier for the parent department.
    - `address` 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 <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
      - `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` DepartmentAddress[]: List of addresses for the department.
      - `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 <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
      - `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.
      - `addressId` integer: The identifier for the department address.
      - `branchId` integer: The identifier for the company branch or department.
      - `companyId` integer: The identifier for the company.
      - `addressType` 'Main' | 'Worksite' | 'Billing' | 'Unknown': The address types available for selection for a department address.
      - `phone` string: The department's phone number.
      - `archive` boolean: An indication of whether the department address is archived or not.
      - `isDefault` boolean: An indication of whether the department address is the default address for the department.
      - `origin` string: The origin of the address of the department.
      - `salesTaxes` SalesTaxOption[]: Sales tax options associated with this address, populated with full tax details.
        - `configSalesTaxGUID` string, uuid: The unique identifier for the sales tax configuration.
        - `name` string: The name of the sales tax.
        - `description` string: A description of the sales tax.
        - `state` string: The US state code this sales tax applies to.
    - `departmentPhone` string: Phone number of the department.
    - `defaultJobOwnerIDs` integer[]: User IDs of the default job owners of the department.
    - `origin` string: The origin of the department.
    - `originId` integer: The identifier for the origin of the department.
    - `weekendDay` string: The week end day for the department. Allowed values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
    - `payPeriod` string: The pay period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `payCycle` string: The pay cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `billingPeriod` string: The billing period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `billingCycle` string: The billing cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `originRecordId` string: The identifier for the origin of the department from partner database.
  - `restrictionDate` string, date-time: The date when the restriction has been added. 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.

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