---
title: "PayrollTaxReturnStatusByBearerToken (Loket.nl REST)"
description: "itgen_loketnl_payrolltaxreturnstatusbybearertoken_plural"
language: nl
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/nl/datamodels/loketnl/LoketNlRest.PayrollProcessStatus.PayrollTaxReturnStatusByBearerToken
original: https://documentation.invantive.eu/en/datamodels/loketnl/LoketNlRest.PayrollProcessStatus.PayrollTaxReturnStatusByBearerToken
updated: 2026-11-19T00:06:19Z
license: https://documentation.invantive.eu/nl/
---

# PayrollTaxReturnStatusByBearerToken: Loket.nl REST itgen_loketnl_payrolltaxreturnstatusbybearertoken_plural

`read only` `REST`

- Catalogus: `LoketNlRest`
- Schema: `PayrollProcessStatus`
- Label: itgen_loketnl_payrolltaxreturnstatusbybearertoken_plural

PayrollTaxreturn-status per wageTaxNumber. __Activiteitnaam :__ GetPayrollTaxReturnStatusByBearerToken

Retourneert een array van payrollAdministrations. Elk object bevat informatie over de loonadministratie en de status van de loonbelastingaangifte voor een loonperiode.


Kan alleen gegevens ophalen.

## API-bron

- Eindpunt: `/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrolltaxreturns/status"`
- Operatie: `get /providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrolltaxreturns/status"`

## Parameters

| Name | Datatype | Required | Default | Documentation |
|---|---|:---:|---|---|
| `payrollPeriodId` | `` | [ ] |  | De unieke identificatie van de op te halen loonperiode. |

## Tabelkolommen

De kolommen van de tabel `PayrollTaxReturnStatusByBearerToken` worden hieronder weergegeven. Elke kolom heeft een SQL-gegevenstype. Voor elke vereiste kolom moet bij het invoegen en bijwerken steeds een nieuwe, niet-lege waarde worden opgegeven.

| Name | Datatype | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `administrationNumber` | `varchar2(15)` | Administratienummer | [ ] |  | Het administratienummer is een vrij veld dat gewoonlijk wordt gebruikt om het debiteurnummer vast te leggen. |
| `cao_key` | `int32` | CAO-sleutel | [ ] |  |  |
| `cao_value` | `varchar2(50)` | CAO-waarde | [ ] |  |  |
| `clientNumber` | `int32` | Klantnummer | [ ] |  | Het clientnummer is een uniek nummer voor administraties die worden gebruikt voor loonverwerking.Dit veld heeft geen waarde als de administratie niet wordt gebruikt voor loonverwerking. |
| `description` | `varchar2` | Description | [ ] |  | De beschrijving wordt gebruikt om de administratie in Loket.nl op werkgeversniveau te identificeren. |
| `employerId` | `guid` | itgen_loketnl_employerid | [ ] |  | De unieke identificatie van een object (GUID/UUID) |
| `employerLogo` | `varchar2` | Logo Werkgever | [ ] |  | De locatie van het logo van de werkgever.Het laatste deel van het teruggegeven eindpunt is de versie van het logo; hierdoor kunnen gebruikers de afbeelding in de cache opslaan.Het wijzigen van de waarde van de versie heeft geen invloed op de uitvoer. |
| `groupClassification_key` | `int32` | itgen_loketnl_groupclassification_key | [ ] |  |  |
| `groupClassification_value` | `varchar2` | itgen_loketnl_groupclassification_value | [ ] |  |  |
| `groupCode` | `int64` | Groepscode | [ ] |  | Nummer (geheel getal) dat wordt gebruikt voor het groeperen van administraties. |
| `hasAutomaticPayroll` | `char` | itgen_loketnl_hasautomaticpayroll | [ ] |  | Geeft aan of automatisch salarisverwerken is ingesteld. |
| `id` | `guid` | ID | [ ] |  | De unieke identificatie van een object (GUID/UUID) |
| `loonmodel_key` | `int32` | itgen_loketnl_loonmodel_key | [ ] |  |  |
| `loonmodel_value` | `varchar2(50)` | itgen_loketnl_loonmodel_value | [ ] |  |  |
| `name` | `varchar2(70)` | Name | [ ] |  | Naam van de administratie |
| `payrollPeriod_payrollPeriodId` | `int32` | itgen_loketnl_payrollperiod_payrollperiodid | [ ] |  | Het jaar en de periode van de loonperiode |
| `payrollPeriod_periodEndDate` | `datetime` | Einddatum Loonperiode | [ ] |  | De laatste dag van de periode waarop de loonperiodegegevens betrekking hebben |
| `payrollPeriod_periodNumber` | `int32` | Nummer Verloningsperiode | [ ] |  | De periode (maand [1 t/m 12], 4 weken [1 t/m 13] of week [1 t/m 53]) |
| `payrollPeriod_periodStartDate` | `datetime` | Startdatum Verloningsperiode | [ ] |  | De eerste dag van de periode waarop de loonperiodegegevens betrekking hebben |
| `payrollPeriod_year` | `int32` | Loonverwerking Jaarperiode | [ ] |  | Het jaar van de loonperiode |
| `payrollPeriodType_key` | `int32` | Loonverwerking Periodesoortsleutel | [ ] |  |  |
| `payrollPeriodType_value` | `varchar2(50)` | Loonverwerking Periodesoortwaarde | [ ] |  |  |
| `payrollTaxReturn_methodOfCreation_key` | `int32` | itgen_loketnl_payrolltaxreturn_methodofcreation_key | [ ] |  | De sleutel die aangeeft hoe de loonrun is aangemaakt. |
| `payrollTaxReturn_methodOfCreation_value` | `varchar2` | itgen_loketnl_payrolltaxreturn_methodofcreation_value | [ ] |  | De waarde die beschrijft hoe de loonrun is aangemaakt. |
| `payrollTaxReturn_possibleActions_key` | `int32` | itgen_loketnl_payrolltaxreturn_possibleactions_key | [ ] |  |  |
| `payrollTaxReturn_possibleActions_value` | `varchar2` | itgen_loketnl_payrolltaxreturn_possibleactions_value | [ ] |  |  |
| `payrollTaxReturn_status_key` | `int32` | itgen_loketnl_payrolltaxreturn_status_key | [ ] |  |  |
| `payrollTaxReturn_status_value` | `varchar2` | itgen_loketnl_payrolltaxreturn_status_value | [ ] |  |  |
| `payrollTaxReturn_userRights_hasConfirmRight` | `char` | itgen_loketnl_payrolltaxreturn_userrights_hasconfirmright | [ ] |  | Geeft aan of de huidige gebruiker het recht heeft voor deze administratie. |
| `payrollTaxReturn_userRights_hasStartRight` | `char` | itgen_loketnl_payrolltaxreturn_userrights_hasstartright | [ ] |  | Geeft aan of de huidige gebruiker het recht heeft voor deze administratie. |
| `shortName` | `varchar2(12)` | Korte Naam | [ ] |  | Verkorte naam van de administratie |
| `wageTaxNumber` | `varchar2(12)` | itgen_loketnl_wagetaxnumber | [ ] |  | Het loonheffingennummer. |


## Release Notes

Wat is er per release veranderd in de tabellen, kolommen, attributen en mogelijkheden van de driver:

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