---
title: "List of billable items for an employer"
method: GET
path: "/billing/providers/employers/{employerId}/billableitems"
tags: ["Billable item"]
---

# List of billable items for an employer

`GET /billing/providers/employers/{employerId}/billableitems`

## Request

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

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

Get a list of all billable items for the 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` BillableItemEmployerObject[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `providerId` string, uuid: The unique identifier of an object (GUID/UUID)
    - `employer` object: Data about the employer.
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `companyName` string
    - `requestedDate` string, date: The date on which the billable item is requested.
    - `requestedBy` object: Data on who has requested the billable item. If the user is still active then the user object is filled. if the user is no longer active, the name field is filled.
      - `user` object, nullable: Data on who has requested the billable item.
        - `id` string, uuid: The unique identifier of an object (GUID/UUID)
        - `firstName` string, nullable: The first name of the user
        - `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: Formatted name of the user.
      - `name` string, nullable: The name of the user
    - `issuedTo` object: Information about the person to whom the billable item was issued. If the person is still active then the person object is filled. if the person is no longer active, the name field is filled.
      - `person` object, nullable: Information on the person to whom the billable item was issued to.
        - `id` string, uuid: The unique identifier of an object (GUID/UUID)
        - `firstName` string, nullable: The first name, given name, forename or Christian name as part of a persons personal name.
        - `lastName` string: The last name, family name or surname as part of a persons personal name.
        - `prefix` string, nullable: The prefix to the last name
        - `initials` string: The initials
        - `lastNamePartner` string, nullable: The last name of the employee's partner.
        - `prefixPartner` string, nullable: The prefix to the last name of the employee's partner.
        - `formattedName` string: Formatted name of the employee based on the value of `howToFormatLastName`
      - `name` string
    - `requestedItem` object: Details on the requested item.
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `itemType` object: Details on the requested item.
        - `id` string, uuid: The item type of the billed item.
        - `description` string: The description of the item type.
      - `preboardingTrajectory` object, nullable: This object contains item type specific data
        - `status` 'open' | 'completed' | 'endedPrematurely': The status of the preboardingTraject.
        - `dateLastModification` string, date: The date on which the status was last modified

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