---
title: "Get registrable entitlements for a placement"
method: GET
path: "/public/entitlement/v1/get-registrable-entitlements-for-placement"
tags: ["Entitlements"]
---

# Get registrable entitlements for a placement

`GET /public/entitlement/v1/get-registrable-entitlements-for-placement`

## 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/entitlement/v1/get-registrable-entitlements-for-placement`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://maqqie.app/auth/realms/maqqie/protocol/openid-connect/token`

Returns the list of entitlements that the company can register for a given placement.

## Query parameters

- `placementId` string, uuid, required
- `projectId` string, uuid

## Response `200`

Successfully retrieved registrable entitlements for the placement.

- RegistrableEntitlementListResponseV1
  - `entitlements` EntitlementItemV1[], required
    - `entitlementId` string, uuid, required: Unique identifier of the entitlement.
    - `name` string, required: The name of the entitlement.
    - `compensationType` 'GROSS' | 'NET', required: Whether this entitlement is a gross or net type.
    - `invoiceLabel` string, required: The wage compensation subtype, shown as a label on the invoice and payslip (e.g. "Declaratie").
    - `fixedAmountInEuros` number: Null for entitlements that do not have a pre-defined amount of €. If this is null, you can (and must) specify an amount in € when registering on this entitlement, i.e. when calling the Registration API
    - `requireSupportingDocument` boolean, required: Whether a supporting document (e.g. receipt) must be attached when registering.
    - `effectiveFrom` string, date, required: The date from which this entitlement is effective.
    - `effectiveUntilInclusive` string, date: The date until which this entitlement is effective, inclusive. Null if the entitlement has no end date.
    - `description` string: Description of the entitlement.
    - `project` EntitlementProjectV1
      - `id` string, uuid, required: Unique identifier of the project.
      - `name` string, required: Name of the project.

## Other responses

- `400`: The request was malformed or invalid.
- `401`: The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403`: The data that the request referred to is inaccessible to the caller.

## Changes

- **2026-09-29** `f9510f3f4b22`: 2 breaking, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `400`
  - added the required property `entitlements` to the response with the `200` status
  - added the required property `error` to the response with the `400` status
  - …1 more
- **2026-09-29** `3352b56bb8fe`: 5 breaking
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `400`
  - removed the required property `entitlements` from the response with the `200` status
  - removed the required property `error` from the response with the `400` status
  - …1 more
- **2026-09-16** `ccf9834e5006`: 2 breaking, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `400`
  - added the required property `entitlements` to the response with the `200` status
  - added the required property `error` to the response with the `400` status
  - …1 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/entitlement/v1/get-registrable-entitlements-for-placement/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)