---
title: "Create a new entitlement registration line"
method: POST
path: "/public/registrations/v1/register-entitlement"
tags: ["Registration"]
---

# Create a new entitlement registration line

`POST /public/registrations/v1/register-entitlement`

Creates a new entitlement registration line with an optional file attachment.

**Attachment Rules:**
- Whether an attachment is required or not allowed is determined by the entitlement configuration.
- entitlements API can be used to fetch the entitlement configuration, which includes whether an attachment is required or not allowed for a specific entitlement.
- If an attachment is required but not provided, the request will be rejected with a 400 error.
- If an attachment is provided when not configured in entitlement, the document will still be stored
- Supported file types for attachments are PDF, PNG and JPEG. If the provided file is not one of these types, the request will be rejected with a 400 error.

## Response `200`

Entitlement registration line created successfully

- EntitlementRegistrationResponseV1 — Response after saving an entitlement registration line
  - `registrationId` string, uuid, required — The ID of the created entitlement registration line
  - `attachmentFileId` string, uuid — The ID of the uploaded attachment file. Null if no attachment was uploaded.

## Other responses

- `400` — The request could not be processed. This could be due to a number of reasons: * The request does not have all required data. * Data in the request is invalid. * Data in the request is inconsistent. * The operation is not allowed given the current state of the data. * The entitlement requires an attachment but none was provided.
- `401` — The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403` — The caller does not have permission to perform this action. This could be due to: * Lacking permission to access the placement's company or worker. * The company or worker being blacklisted for time writing.

---

[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)