---
title: "Get Multiple Placements by Their Placement GUIDs"
method: POST
path: "/v1/placement/multi-query"
tags: ["Placement"]
---

# Get Multiple Placements by Their Placement GUIDs

`POST /v1/placement/multi-query`

Retrieves multiple placement records using their placement GUIDs and returns the associated talent objects or error details.

## Headers

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

## Request body

- string[]

## Response `200`

200 response

- MultiQueryResultOfPlacementAndGuid
  - `totalRequestedCount` integer — The total number of placement records requested in the query.
  - `foundCount` integer — The number of placement records found and returned.
  - `errorCount` integer — The number of placement records that could not be retrieved due to errors.
  - `items` Placement[] — Placement records details.
    - `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.
  - `errors` MultiQueryErrorReasonOfGuid[] — Error details.
    - `key` string, guid — The unique identifier associated with the error.
    - `errorReason` string — The reason or description explaining the error.

## Other responses

- `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/revisions/846b33e4e71b/schema)