Registration

Get registrations for the calling company

Changed on Sep 29, 2026

Lists all non-deleted registrations for the company of the caller, grouped per registration with the individual registration lines nested. A single registration is associated with 1 or more registration lines, for example normal hours plus a surcharge line.

The line amounts reflect the values at registration/approval time: price/pricePerUnit are the amounts charged to the company, wageAmount/wagePerUnit are the gross wage amounts for the worker.

Filters

All filters are optional and combined with AND. A registration is included when at least one of its lines matches all filters, and it contains only the matching lines. For example, when filtering on a date range, lines of the same registration that fall outside the range are omitted from the response.

Paging

Results are paged over registrations (not lines), ordered by the earliest matching line date per registration. Paging is controlled by the page object in the request; defaults are number=0 and size=25.

post/public/registrations/v1/get-registrations

Request

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

Request body

startDatestring date

Inclusive lower bound for the registration line date. Format: ISO 8601 (YYYY-MM-DD).

endDatestring date

Inclusive upper bound for the registration line date. Format: ISO 8601 (YYYY-MM-DD).

workerIdstring uuid

The UUID of the worker to filter registrations by.

placementIdstring uuid

The UUID of the placement to filter registrations by.

Response

Successfully listed the registrations matching the filters.

Example response

{
  "registrations": [
    {
      "lines": [
        {
          "startTime": "2026-08-13T15:30:00Z",
          "breakDuration": "PT1H30M"
        }
      ]
    }
  ]
}

Changes

Sep 29, 2026f9510f3f4b22 Revision changes
- breaking
  the request's body type changed from no type to object
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to string for status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Sep 29, 20263352b56bb8fe Revision changes
- breaking
  the request's body type changed from object to no type
- breaking
  the response's body type changed from object to no type for status
- breaking
  the response's body type changed from string to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- info
  response schema application/json enum value removed INVALID_DATE_RANGE

Operation history (9 revisions)