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

## Request

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

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.dev/avionte/apis/aviont-back-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/aviont-back-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/aviont-back-office-api/revisions/175a738cecd0?raw)