---
title: "RunRequestsByCompanyYear (Nmbrs)"
description: "Company Run Requests Year"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Company.RunRequestsByCompanyYear
original: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Company.RunRequestsByCompanyYear
updated: 2026-11-01T17:57:29Z
license: https://documentation.invantive.eu/en/
---

# RunRequestsByCompanyYear: Nmbrs Company Run Requests Year

`read only` `per partition` `XML`

- Catalog: `Nmbrs`
- Schema: `Company`
- Label: Company Run Requests Year

The data in this table is partitioned per value of the `COMPANY_CODE` column.

Can only retrieve data.

## API Source

- XML service: `CompanyService.asmx`
- XML topic: `RunRequest_GetList`
- XML path: `/ncs:RunRequest_GetListResult/ncs:RunRequest`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 49 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `Year` | `number` | [x] |  | Payroll year. |

## Table Columns

The columns of the table `RunRequestsByCompanyYear` 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 |
|---|---|---|:---:|---|---|
| `COMPANYID` | `int32` | Company ID | [ ] |  |  |
| `COMPANY_CODE` | `int64` | Company ID | [x] |  |  |
| `HANDLEDDATE` | `datetime` | Date Handled | [ ] | `/soap:Envelope/soap:Body/ncs:RunRequest_GetListResponse/ncs:RunRequest_GetListResult/ncs:RunRequest/ncs:HandledDate` |  |
| `PERIOD` | `int32` | Period | [ ] | `/soap:Envelope/soap:Body/ncs:RunRequest_GetListResponse/ncs:RunRequest_GetListResult/ncs:RunRequest/ncs:Period` |  |
| `STATUS` | `varchar2` | Status | [ ] | `/soap:Envelope/soap:Body/ncs:RunRequest_GetListResponse/ncs:RunRequest_GetListResult/ncs:RunRequest/ncs:Status` |  |
| `YEAR` | `int32` | Year | [ ] | `/soap:Envelope/soap:Body/ncs:RunRequest_GetListResponse/ncs:RunRequest_GetListResult/ncs:RunRequest/ncs:Year` |  |



## Release Notes

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

- [Nmbrs](/en/release-notes/drivers?driver=nmbrs)

