---
title: "Get a list of notifications for an employer."
method: GET
path: "/v2/providers/employers/{employerId}/notifications"
tags: ["Notification"]
---

# Get a list of notifications for an employer.

`GET /v2/providers/employers/{employerId}/notifications`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/{employerId}/notifications`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/GetNotificationsByEmployerId" target="_blank">GetNotificationsByEmployerId</a>

Get a list of unread notifications for an employer

## Path parameters

- `employerId` string, uuid, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageNumber` integer
- `pageSize` integer

## Headers

- `Authorization` string, required
- `Accept` string, required

## Response `200`

OK

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `totalSize` integer: Total number of records, taking into account the given filter.
  - `pageSize` integer: Number of records in the response
  - `totalPages` integer: Number of pages available
  - `currentPage` integer: Current page returned in the response
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `_embedded` Notification[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `notificationType` object: The type of notification
      - `key` integer
      - `value` string
    - `notificationTypeClarification` string, nullable: Optional text
    - `isRead` boolean: Indicates whether the notification has been read
    - `notificationDate` string, date: The date on which the event of the notificationType (e.g. birthday or anniversary) will occure
    - `markedAsReadBy` UserBasic, nullable
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `initials` string: The initials of the user
      - `prefix` string, nullable: The prefix of the user
      - `lastName` string: The last name of the user
      - `formattedName` string: preformatted user name for displaying. \<lastname\>\", \"\<initials\>\" \"\<prefix\>
    - `markedAsReadOn` string, date-time, nullable: The time at which the notificiation was marked as read.
    - `appliesToEmployee` EmployeeBasic
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `employeeNumber` integer: The employee number to uniquely identify a employee within a employer.
      - `firstName` string, nullable: The first name of the employee
      - `initials` string: The initials of the employee
      - `prefix` string, nullable: The prefix of the employee
      - `lastName` string: The last name of the employee
      - `prefixPartner` string, nullable: The prefix of the partner of the employee
      - `lastNamePartner` string, nullable: The last name of the partner of the employee
      - `formattedName` string: Formatted name of the employee based on the value of `howToFormatLastName`
      - `dateOfBirth` string, date: The date of birth
      - `photo` string, url, nullable: A photo of the employee to use as a avatar/profile picture. The last part of the returned endpoint is the version of the logo this allows users to cache the image. Changing the value of the version will not influence the output.
    - `appliesToEmployment` string, uuid, nullable: The unique identifier of an object (GUID/UUID)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)