---
title: "Query Multiple Placements"
method: POST
path: "/v1/placements/multi-query"
tags: ["Placements"]
---

# Query Multiple Placements

`POST /v1/placements/multi-query`

Returns details about the specified placements.

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- IntegerSchema[]

## Response `200`

The placements for the specified IDs.

- Placement[]
  - `placementGuid` string, uuid — The unique identifier for the placement, formatted as a GUID.
  - `branchGuid` string, uuid — The unique identifier for the branch associated with the talent, formatted as a GUID.
  - `backOfficeAssignmentId` integer — The ID of the Assignment in the Back Office.
  - `WorkSiteAddress` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — 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>.
  - `isW2` boolean — An indication of whether the placement is a W2 placement (true) or a contract placement (false).
  - `agencyGuid` string, uuid — The vendor agency GUID, used when the placement is a contract placement (IsW2 = false) and payment should be directed to the vendor instead of the talent.
  - `jobTitle` string — Job title for the placement, as defined on the Job.
  - `payPeriod` 'Unknown' | 'Weekly' | 'BiWeekly' | 'Monthly' | 'SemiMonthly' | 'Daily' | 'Yearly' | 'Hourly'
  - `placementSchedules` PlacementSchedule[] — A list of all schedules associated with the placement.
    - `placementScheduleGuid` string, uuid — The unique identifier for the placement schedule, formatted as a GUID.
    - `startDate` string, date — Start date of the placement schedule in YYYY-MM-DD format, without a timestamp.
    - `endDate` string, date — End date of the placement schedule in YYYY-MM-DD format, without a timestamp.
    - `isActive` boolean — An indication of whether the schedule is active. Only one schedule can be active for a placement.
    - `placementRates` PlacementRate[] — A list of all rates for the particular placement schedule.
      - `placementRateGuid` string, uuid — The unique identifier for the placement rate, formatted as a GUID.
      - `transactionTypeId` integer — The unique identifier for the pay/bill code.
      - `transactionType` string — The pay or bill code associated with the transaction.
      - `payRate` number — Pay rate for the particular pay/bill code.
      - `billRate` number — Bill rate for the particular pay/bill code.

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