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

# Get active placements for the given worker

`GET /public/placement/v1/get-active-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-active-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-active-placements/get.ts> (a function with typed inputs; its response is checked against the schema)

Get placements for the given worker.
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-active-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)