# employees resource type (v1.0)
> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.
Represents an employee in Business Central.
> NOTE
> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.
## Methods
Method|Return Type|Description
../api/dynamics_employee_get|employees|Get an employee object.
POST employees<../api/dynamics_create_employee>|employees|Create an employee object.
PATCH employees<../api/dynamics_employee_update>|employees|Update an employee object.
../api/dynamics_employee_delete|none|Delete an employee object.
## Subpages
Method|Return Type|Description
../api/dynamics_employee_get_defaultdimensions|default dimensions|Gets the default dimensions of employee.
POST employee defaultDimensions<../api/dynamics_employee_create_defaultdimensions>|default dimensions|Creates the default dimensions of employee.
PATCH employee defaultDimensions<../api/dynamics_employee_update_defaultdimensions>|default dimensions|Updates the default dimensions of employee.
../api/dynamics_employee_delete_defaultdimensions|default dimensions|Deletes the default dimensions of employee.
## Properties
Property|Type|Description
id|GUID|The employee ID. Non-editable.
number|string|The employee number. Read-Only.
displayName|string|The employee givenName + surname. Read-Only.
givenName|string|The given name of the employee.
middleName|string|The middle name of the employee.
surname|string|The surname of the employee
jobTitle|string|The full name of the employee
address|NAV.PostalAddress<dynamics_complextypes>|Specifies the employee's address. This address will appear on all resource documents for the employee.
phoneNumber|string|Specifies the employee's telephone number.
mobilePhone|string|Specifies the employee's mobile telephone number.
email|string|Specifies the employee's email address.
personalEmail|string|Specifies the employee's personal email address.
employmentDate|date|Specifies the date when the employee began to work for the company.
terminationDate|date|Specifies the date when the employee was terminated, due to retirement or dismissal, for example.
status|string|Specifies the employee's status. Possible values are Active, Inactive or Terminated
birthDate|date|Specifies the employee's date of birth.
picture|stream|The employee picture. Read-Only.
lastModifiedDateTime|datetime|The last datetime the employee was modified. Read-Only.
## Relationships
None
## JSON representation
Here is a JSON representation of the resource.
```json
{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "givenName": "string",
    "middleName": "string",
    "surname": "string",
    "jobTitle": "string",
    "address": "NAV.PostalAddress",
    "phoneNumber": "string",
    "mobilePhone": "string",
    "email": "string",
    "personalEmail": "string",
    "employmentDate": "date",
    "terminationDate": "date",
    "status": "string",
    "birthDate": "date",
    "picture": "stream",
    "lastModifiedDateTime": "datetime"
}
```
## Related information
../dynamics_error_codes
../api/dynamics_employee_get
Post Employee<../api/dynamics_create_employee>
Patch Employee<../api/dynamics_employee_update>
../api/dynamics_employee_delete

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_employee/
