---
title: "PayrollStatusByBearerToken (Loket.nl REST)"
description: "itgen_loketnl_payrollstatusbybearertoken_plural"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/loketnl/LoketNlRest.PayrollProcessStatus.PayrollStatusByBearerToken
original: https://documentation.invantive.eu/en/datamodels/loketnl/LoketNlRest.PayrollProcessStatus.PayrollStatusByBearerToken
updated: 2024-06-10T18:51:26Z
license: https://documentation.invantive.eu/en/
---

# PayrollStatusByBearerToken: Loket.nl REST itgen_loketnl_payrollstatusbybearertoken_plural

`read only` `REST`

- Catalog: `LoketNlRest`
- Schema: `PayrollProcessStatus`
- Label: itgen_loketnl_payrollstatusbybearertoken_plural

Payroll status for each administration.
__Activity name :__ GetPayrollStatusByBearerToken

Returns an array of payrollAdministrations. Each object contains information about the payrolladministration and the payroll run status for an payroll period.


Can only retrieve data.

## API Source

- Endpoint: `/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns/status`
- Operation: `get /providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns/status`

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `payrollPeriodId` | `` | [ ] |  | The unique identifier of the payroll period to return. |

## Table Columns

The columns of the table `PayrollStatusByBearerToken` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `administrationNumber` | `varchar2(15)` | Administration Number | [ ] |  | The administration number is a free field commonly used to register the debtors number. |
| `cao_key` | `int32` | CAO Key | [ ] |  |  |
| `cao_value` | `varchar2(50)` | CAO Value | [ ] |  |  |
| `clientNumber` | `int32` | Client Number | [ ] |  | The client number is a unique number for administrations that are used for payrolling. This field has no value if the administration is not used for payrolling. |
| `description` | `varchar2` | Description | [ ] |  | The description is used to identify the administration in Loket.nl at Employerlevel. |
| `employerId` | `guid` | itgen_loketnl_employerid | [ ] |  | The unique identifier of an object (GUID/UUID) |
| `employerLogo` | `varchar2` | Employer Logo | [ ] |  | 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. |
| `groupClassification_key` | `int32` | itgen_loketnl_groupclassification_key | [ ] |  |  |
| `groupClassification_value` | `varchar2` | itgen_loketnl_groupclassification_value | [ ] |  |  |
| `groupCode` | `int64` | Group Code | [ ] |  | Number (integer) used for grouping administrations. |
| `hasAutomaticPayroll` | `char` | itgen_loketnl_hasautomaticpayroll | [ ] |  | Indicates whether automatic payrolling is set |
| `id` | `guid` | ID | [ ] |  | The unique identifier of an object (GUID/UUID) |
| `loonmodel_key` | `int32` | itgen_loketnl_loonmodel_key | [ ] |  |  |
| `loonmodel_value` | `varchar2(50)` | itgen_loketnl_loonmodel_value | [ ] |  |  |
| `name` | `varchar2(70)` | Name | [ ] |  | Name of the administration |
| `payroll_methodOfCreation_key` | `int32` | itgen_loketnl_payroll_methodofcreation_key | [ ] |  | The key indicating how the payroll run was created. |
| `payroll_methodOfCreation_value` | `varchar2` | itgen_loketnl_payroll_methodofcreation_value | [ ] |  | The value describing how the payroll run was created. |
| `payroll_possibleActions_additionalInformation_key` | `int32` | itgen_loketnl_payroll_possibleactions_additionalinformation_key | [ ] |  | The key of the additional information |
| `payroll_possibleActions_additionalInformation_value` | `varchar2` | itgen_loketnl_payroll_possibleactions_additionalinformation_value | [ ] |  | The additional information on the possible action. |
| `payroll_possibleActions_key` | `int32` | itgen_loketnl_payroll_possibleactions_key | [ ] |  |  |
| `payroll_possibleActions_value` | `varchar2` | itgen_loketnl_payroll_possibleactions_value | [ ] |  |  |
| `payroll_status_key` | `int32` | itgen_loketnl_payroll_status_key | [ ] |  |  |
| `payroll_status_value` | `varchar2` | itgen_loketnl_payroll_status_value | [ ] |  |  |
| `payroll_userRights_hasCalculateWorkingHoursRight` | `char` | itgen_loketnl_payroll_userrights_hascalculateworkinghoursright | [ ] |  | indicates whether the current user has the right for this administration. |
| `payroll_userRights_hasCancelRight` | `char` | itgen_loketnl_payroll_userrights_hascancelright | [ ] |  | indicates whether the current user has the right for this administration. |
| `payroll_userRights_hasConfirmRight` | `char` | itgen_loketnl_payroll_userrights_hasconfirmright | [ ] |  | indicates whether the current user has the right for this administration. |
| `payroll_userRights_hasStartRight` | `char` | itgen_loketnl_payroll_userrights_hasstartright | [ ] |  | indicates whether the current user has the right for this administration. |
| `payrollPeriod_payrollPeriodId` | `int32` | itgen_loketnl_payrollperiod_payrollperiodid | [ ] |  | The year and period of the payroll period  |
| `payrollPeriod_periodEndDate` | `datetime` | Payroll Period End Date | [ ] |  | The last day of the period to which the payroll period data applies  |
| `payrollPeriod_periodNumber` | `int32` | Payroll Period Number | [ ] |  | The period (month [1 to 12] , 4 weeks [1 to 13] or week [1 to 53])  |
| `payrollPeriod_periodStartDate` | `datetime` | Payroll Period Start Date | [ ] |  | The first day of the period to which the payroll period data applies  |
| `payrollPeriod_year` | `int32` | Payroll Period Year | [ ] |  | The year of the payroll period  |
| `payrollPeriodType_key` | `int32` | Payroll Period Type Key | [ ] |  |  |
| `payrollPeriodType_value` | `varchar2(50)` | Payroll Period Type Value | [ ] |  |  |
| `shortName` | `varchar2(12)` | Short Name | [ ] |  | Shortened name of the administration |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Loket.nl REST](/en/release-notes/drivers?driver=loket-nl-rest)

