---
title: "EmployeeAddressesByEmployeeYearPeriod (Nmbrs)"
description: "Employee Addresses by Employee, Year and Period"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Employees.EmployeeAddressesByEmployeeYearPeriod
original: https://documentation.invantive.eu/en/datamodels/nmbrs/Nmbrs.Employees.EmployeeAddressesByEmployeeYearPeriod
updated: 2026-11-01T17:57:29Z
license: https://documentation.invantive.eu/en/
---

# EmployeeAddressesByEmployeeYearPeriod: Nmbrs Employee Addresses by Employee, Year and Period

`read only` `XML`

- Catalog: `Nmbrs`
- Schema: `Employees`
- Label: Employee Addresses by Employee, Year and Period

Can only retrieve data.

## API Source

- XML service: `EmployeeService.asmx`
- XML topic: `Address_GetList`
- XML path: `/nes:Address_GetListResult/nes:EmployeeAddress`

## Performance Characteristics

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

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `EmployeeId` | `number` | [x] |  | Numeric ID of employee. |
| `Period` | `number` | [x] |  | Payroll period within year. |
| `Year` | `number` | [x] |  | Payroll year. |

## Table Columns

The columns of the table `EmployeeAddressesByEmployeeYearPeriod` 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 |
|---|---|---|:---:|---|---|
| `CITY` | `varchar2` | City | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:City` |  |
| `COUNTRYISOCODE` | `varchar2` | Country ISO Code | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:CountryISOCode` |  |
| `DEFAULT` | `char` | Default | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:Default` |  |
| `EMPLOYEEID` | `int32` | Employee ID | [ ] |  |  |
| `HOUSENUMBER` | `varchar2` | House Number | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:HouseNumber` |  |
| `HOUSENUMBERADDITION` | `varchar2` | House Number Addition | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:HouseNumberAddition` |  |
| `ID` | `int32` | ID | [x] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:Id` |  |
| `POSTALCODE` | `varchar2` | Postal Code | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:PostalCode` |  |
| `STATEPROVINCE` | `varchar2` | State/Province | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:StateProvince` |  |
| `STREET` | `varchar2` | Street | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:Street` |  |
| `TYPE` | `varchar2` | Type | [ ] | `/soap:Envelope/soap:Body/nes:Address_GetListResponse/nes:Address_GetListResult/nes:EmployeeAddress/nes:Type` | One of 'HomeAddress', 'PostAddress', 'AbsenceAddress', 'HolidaysAddress', 'WeekendAddress'. |



## Release Notes

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

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

