---
title: "Details of an benefit in kind"
method: GET
path: "/v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}"
tags: ["Benefit in kind"]
---

# Details of an benefit in kind

`GET /v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/employments/benefitsinkind/{benefitInKindId}`
- Auth: none required

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

Get the details of a benefit in kind

## Path parameters

- `benefitInKindId` 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` BenefitInKind[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: The date on which this BenefitInKind starts. So multiple Benefits in kind can be active at the same time but one specific BenefitsInKind can never be active multiple times at the same time.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `benefitInKindType` object: The benefit in kind of the employment. `benefitinkind` is a metadata field within the employer context. Possible values can be managed by the user.
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `description` string
    - `brand` string, nullable: The brand of the benefit in kind.
    - `type` string, nullable: The type of the benefit in kind.
    - `value` number: The value for the selected benefit of kind.
    - `supplier` string, nullable: The supplier of the benefit in kind.
    - `particularities` string, nullable: Extra information about the benefit in kind

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