---
title: "List of employers with fewer fields for performance reasons"
method: GET
path: "/v2/providers/employers/minimized"
tags: ["Employer"]
---

# List of employers with fewer fields for performance reasons

`GET /v2/providers/employers/minimized`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/minimized`
- Auth: none required

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

Get a list of all employers accessible to the current user.  With this endpoint we introduced the "Minimized" resource which contains fewer fields then `/v2/providers/employers`. This version should increase performance when requesting employments for large employers.

## 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` EmployerMinimized[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `companyName` string: Name of the company
    - `address` AddressCompact
      - `street` string: Streetname of the address
      - `houseNumber` integer: House number of the address
      - `postalCode` string: The postal code of the address
      - `city` string: City of the address
    - `providerSettings` ProviderSettingsCompact
      - `administrationNumber` string, nullable: A free field that is most commonly used to store the Debtors Number the provider uses for the employer. This field is used as a key field in some of the existing SOAP webservices.
      - `groupCode` integer, nullable: The groupcode is used for grouping employers. It is used for filtering output and processes (only include employers in group 40 in this report). This field does not support 0 as a value. If 0 is send it will be stored as NULL.
    - `contactInformation` ContactInformationCompact
      - `phoneNumber` string, nullable: The telephone number of the employer
    - `contact` ContactCompact
      - `name` string, nullable: Name of the contact of the employer
      - `phoneNumber` string, nullable: The general phone number of the employer
    - `employerLogo` string, url, nullable: The location of the logo of the employer. 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.
    - `providerLogo` string, url, nullable: This logo is displayed in the interface of loket.nl. if null no deviating logo is present and the normal provider logo should be used (aquire the URL to the logo via ../v2/providers)
    - `branch` Branch, nullable
      - `key` integer: The key of the branch. Possible values can be aquired via the metadata endpoint
      - `value` string: Description of the branch. Branch is only available in Dutch
    - `employerNumber` integer: The employer number is used in various overviews and exports to identify a specific employer in Loket (please note: this is not the identifier used in the REST API).

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