---
title: "Get all placements for the given worker"
method: GET
path: "/public/placement/v1/get-placements"
tags: ["Placement"]
---

# Get all placements for the given worker

`GET /public/placement/v1/get-placements`

## Request

- Base URL: `https://api.maqqie.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maqqie.app/public/placement/v1/get-placements`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://maqqie.app/auth/realms/maqqie/protocol/openid-connect/token`
- TypeScript: <https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/placement/v1/get-placements/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all placements for the given worker, including past placements.
The response is sorted by descending end date of the placement, then by descending start date.

## Query parameters

- `workerId` string, uuid, required: The unique id of the worker, as returned from the /create-worker endpoint.

## Response `200`

Success

- PlacementResponseV1[]
  - `placementId` string, uuid, required: The unique id of the placement.
  - `function` string: The function of the worker on the placement.
  - `startDate` string, date, required: The start date of the placement's contract.
  - `endDate` string, date: The end date of the placement's contract. The contract runs up to and including this date.
  - `rates` RateV1[], required: The rate history of the placement, ordered by ascending effective date. Each rate applies from its effective date until the effective date of the next rate.
    - `effectiveDate` string, date, required: The date from which this rate applies.
    - `wage` number, required: The gross hourly wage of the worker, in €.
    - `rate` number, required: The hourly rate charged to the company, in €.

## Changes

- **2026-09-29** `f9510f3f4b22`: 1 breaking, 5 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `items/endDate` to the response with the `200` status
  - added the optional property `items/function` to the response with the `200` status
  - added the required property `items/placementId` to the response with the `200` status
  - …2 more
- **2026-09-29** `3352b56bb8fe`: 4 breaking, 2 warning
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/placementId` from the response with the `200` status
  - removed the required property `items/rates` from the response with the `200` status
  - removed the required property `items/startDate` from the response with the `200` status
  - …2 more
- **2026-09-16** `ccf9834e5006`: 1 breaking, 5 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `items/endDate` to the response with the `200` status
  - added the optional property `items/function` to the response with the `200` status
  - added the required property `items/placementId` to the response with the `200` status
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/placement/v1/get-placements/get.md)

---

[API](https://skmtc.dev/maqqie/apis/maqqie-public-api.md) - [All operations](https://skmtc.dev/maqqie/apis/maqqie-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maqqie/apis/maqqie-public-api/revisions/13ed331da2b2?raw)