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

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.

---

[API](https://skmtc.net/maqqie/apis/maqqie-public-api.md) · [All operations](https://skmtc.net/maqqie/apis/maqqie-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maqqie/maqqie-public-api/revisions/41e5cd97d4d7/schema)
