---
title: "List of company cars for an employment"
method: GET
path: "/v2/providers/employers/employees/employments/{employmentId}/companycars"
tags: ["Company car"]
---

# List of company cars for an employment

`GET /v2/providers/employers/employees/employments/{employmentId}/companycars`

## Request

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

__Activity name:__ <a href="https://developer.loket.nl/Activities/GetCompanyCarsByEmploymentId" target="_blank">GetCompanyCarsByEmploymentId</a><br>    <br><br>Get the list of company cars for an employment. <br><br>Please note this resource is related for the registration of the company car for HRM purposes. This resource is NOT related to the registration of the fiscal company car(s) which is used in salary calculations.<br>

## Path parameters

- `employmentId` 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` CompanyCar[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: The start date of the entity.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `brand` string, nullable: Brand of the vehicle.
    - `model` string, nullable: Model of the vehicle.
    - `licensePlateNumber` string: Vehicle registration number (license plate) of the company car. The number should be provided with or without any hyphens (-).
    - `fuelCardNumber` string, nullable: Registration number of the fuel card.
    - `leaseOrBuy` object: Indication of the ownership of the company car.
      - `key` integer
      - `value` string
    - `supplier` string, nullable: Name of the company the delivered the company car.
    - `lease` object, nullable: Details of the leasecontract
      - `startDate` string, date, nullable: The start date of the entity.
      - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
      - `contractNumber` string, nullable: Registration number of the lease contract.
    - `catalogValue` number, double, nullable: The catalog value of the car.
    - `kilometersPrivateUse` integer, nullable: The number kilometers per year the employee can use the car for private purposes.
    - `comments` string, nullable: Any comments on the car or the contract.

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