---
id: object/page/20017
type: object
title: Page 20017 "APIV1 - Employees"
summary: Page 20017 "APIV1 - Employees" in APIV1 (Microsoft.API.V1). Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - apiv1
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 3207955cd4bdee484b5afae25492eae38dabf43df025b769f6774f9b5b9ad4e1
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1Employees.Page.al
    title: src/Apps/W1/APIV1/app/src/pages/APIV1Employees.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_create_defaultdimensions
    title: (v1.0) Create employee defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete_defaultdimensions
    title: (v1.0) Delete employee defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete
    title: (v1.0) Delete employees
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get_defaultdimensions
    title: (v1.0) Get employee defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get
    title: (v1.0) Get employees
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update_defaultdimensions
    title: (v1.0) Update employee defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update
    title: (v1.0) Update employees
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee
    title: (v1.0) employees resource type
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_create_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 20017
name: APIV1 - Employees
namespace: Microsoft.API.V1
app: APIV1
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_create_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_get_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_get.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_update_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_employee_update.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/resources/dynamics_employee.md
counts:
  fields: 0
  procedures: 3
  events: 0
  subscribers: 0
  controls: 21
  actions: 0
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 2
  called_by: 0
  implements: 0
---

# Page 20017 "APIV1 - Employees"

> Page 20017 "APIV1 - Employees" in APIV1 (Microsoft.API.V1). Introduced in BC29, still in BC30.

APIV1 · Microsoft.API.V1 · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1Employees.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | 'employees', Locked = true |
| Extensible | false |
| SourceTable | Employee |
| PageType | API |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| Group | id | `Rec.SystemId` | — |
|  | number | [No.](../table/5200.md#fields) | Specifies the number of the involved entry or record, according to the specified number series. <small>from the table field</small> |
|  | displayName | `EmployeeDisplayName` | — |
|  | givenName | [First Name](../table/5200.md#fields) | Specifies the employee's first name. <small>from the table field</small> |
|  | middleName | [Middle Name](../table/5200.md#fields) | Specifies the employee's middle name. <small>from the table field</small> |
|  | surname | [Last Name](../table/5200.md#fields) | Specifies the employee's last name. <small>from the table field</small> |
|  | jobTitle | [Job Title](../table/5200.md#fields) | Specifies the employee's job title. <small>from the table field</small> |
|  | address | `PostalAddressJSON` | Specifies the address for the employee. |
|  | phoneNumber | [Phone No.](../table/5200.md#fields) | Specifies the employee's telephone number. <small>from the table field</small> |
|  | mobilePhone | [Mobile Phone No.](../table/5200.md#fields) | Specifies the employee's private telephone number. <small>from the table field</small> |
|  | email | [Company E-Mail](../table/5200.md#fields) | Specifies the employee's email address at the company. <small>from the table field</small> |
|  | personalEmail | [E-Mail](../table/5200.md#fields) | Specifies the employee's private email address. <small>from the table field</small> |
|  | employmentDate | [Employment Date](../table/5200.md#fields) | Specifies the date when the employee began to work for the company. <small>from the table field</small> |
|  | terminationDate | [Termination Date](../table/5200.md#fields) | Specifies the date when the employee was terminated, due to retirement or dismissal, for example. <small>from the table field</small> |
|  | status | [Status](../table/5200.md#fields) | Specifies the employment status of the employee. <small>from the table field</small> |
|  | birthDate | [Birth Date](../table/5200.md#fields) | Specifies the employee's date of birth. <small>from the table field</small> |
|  | statisticsGroupCode | [Statistics Group Code](../table/5200.md#fields) | Specifies a statistics group code to assign to the employee for statistical purposes. <small>from the table field</small> |
|  | lastModifiedDateTime | [Last Modified Date Time](../table/5200.md#fields) | — |
|  | picture | part [Page 20055 "APIV1 - Pictures"](../page/20055.md) | — |
|  | defaultDimensions | part [Page 20056 "APIV1 - Default Dimensions"](../page/20056.md) | — |
|  | timeRegistrationEntries | part [Page 20041 "APIV1 - Time Registr. Entries"](../page/20041.md) | — |

## Procedures

3 local procedures, no public ones.

## Triggers

OnAfterGetRecord, OnInsertRecord, OnModifyRecord, OnNewRecord

## Relations

- source table [Table 5200 "Employee"](../table/5200.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 5483 "Graph Mgt - Employee"](../codeunit/5483.md) (3 calls: `OnInsertRecord → ProcessComplexTypes`, `OnModifyRecord → ProcessComplexTypes`, `SetCalculatedFields → PostalAddressToJSON`)
- [Codeunit 5465 "Graph Mgt - General Tools"](../codeunit/5465.md) (1 call: `OnInsertRecord → ProcessNewRecordFromAPI`)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [(v1.0) Create employee defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_create_defaultdimensions)
- [(v1.0) Delete employee defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete_defaultdimensions)
- [(v1.0) Delete employees](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_delete)
- [(v1.0) Get employee defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get_defaultdimensions)
- [(v1.0) Get employees](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_get)
- [(v1.0) Update employee defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update_defaultdimensions)
- [(v1.0) Update employees](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_employee_update)
- [(v1.0) employees resource type](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "APIV1 - Employees")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.