{"title":"employee resource type","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v2.0/resources/dynamics_employee/","by":"JOP-AL","license":"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/v2.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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_employee","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"An employee object in Dynamics 365 Business Central.","date":"2026-08-21","meta":{"topic":"reference"},"outline":[{"level":1,"title":"employee resource type","slug":"employee-resource-type","at":0,"chars":3773},{"level":2,"title":"Methods","slug":"methods","at":227,"chars":339},{"level":2,"title":"Navigation","slug":"navigation","at":566,"chars":420},{"level":2,"title":"Properties","slug":"properties","at":986,"chars":1779},{"level":2,"title":"JSON representation","slug":"json-representation","at":2765,"chars":830},{"level":2,"title":"Related information","slug":"related-information","at":3595,"chars":178}],"text":"# employee resource type\nRepresents an employee in Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_employee_get|employee|Gets an employee object.\n../api/dynamics_employee_delete|none|Deletes an employee object.\nPOST employee<../api/dynamics_employee_create>|employee|Creates an employee object.\nPATCH employee<../api/dynamics_employee_update>|employee|Updates an employee object.\n## Navigation\nNavigation|Return Type|Description\ndynamics_picture|picture|Gets the picture of the employee.\ndynamics_defaultdimension|defaultDimensions|Gets the defaultdimensions of the employee.\ntimeRegistrationEntries<dynamics_timeregistrationentry>|timeRegistrationEntries|Gets the timeregistrationentries of the employee.\ndynamics_documentattachment|documentAttachments|Gets the documentattachments of the employee.\n## Properties\n|Property|Type|Description|\n|id|GUID|The unique ID of the employee. Non-editable.|\n|number|string|Specifies the number of the employee.|\n|displayName|string|Specifies the employee's name. This name will appear on all sales documents for the employee.|\n|givenName|string|The given name of the employee.|\n|middleName|string|The middle name of the employee.|\n|surname|string|The surname of the employee.|\n|jobTitle|string|The job title of the employee.|\n|addressLine1|string|Specifies the employee's address. This address will appear on all sales documents for the employee.|\n|addressLine2|string|Specifies the employee's address. This address will appear on all sales documents for the employee.|\n|city|string|Specifies the employee's city.|\n|state|string|Specifies the employee's state.|\n|country|string|Specifies the employee's country.|\n|postalCode|string|Specifies the employee's postal code.|\n|phoneNumber|string|Specifies the employee's telephone number.|\n|mobilePhone|string|Specifies the employee's mobile telephone number.|\n|email|string|Specifies the employee's email address.|\n|personalEmail|string|Specifies the employee's personal email address.|\n|employmentDate|date|Specifies the date when the employee began to work for the company.|\n|terminationDate|date|Specifies the date when the employee was terminated, due to retirement or dismissal, for example.|\n|status|NAV.employeeStatus|Specifies the status of the employee. It can be \"Active\", \"Inactive\" or \"Terminated\".|\n|birthDate|date|Specifies the employee's date of birth.|\n|statisticsGroupCode|string|The employee's statistics group code.|\n|bankBranchNumber|string||\n|bankAccountNumber|string||\n|iban|string||\n|lastModifiedDateTime|datetime|The last datetime the employee was modified. Read-Only.|\n## JSON representation\nHere's a JSON representation of the employee resource.\n```json\n{\n    \"id\": \"GUID\",\n    \"number\": \"string\",\n    \"displayName\": \"string\",\n    \"givenName\": \"string\",\n    \"middleName\": \"string\",\n    \"surname\": \"string\",\n    \"jobTitle\": \"string\",\n    \"addressLine1\": \"string\",\n    \"addressLine2\": \"string\",\n    \"city\": \"string\",\n    \"state\": \"string\",\n    \"country\": \"string\",\n    \"postalCode\": \"string\",\n    \"phoneNumber\": \"string\",\n    \"mobilePhone\": \"string\",\n    \"email\": \"string\",\n    \"personalEmail\": \"string\",\n    \"employmentDate\": \"date\",\n    \"terminationDate\": \"date\",\n    \"status\": \"NAV.employeeStatus\",\n    \"birthDate\": \"date\",\n    \"statisticsGroupCode\": \"string\",\n    \"bankBranchNumber\": \"string\",\n    \"bankAccountNumber\": \"string\",\n    \"iban\": \"string\",\n    \"lastModifiedDateTime\": \"datetime\"\n}\n```\n## Related information\n../api/dynamics_employee_get\n../api/dynamics_employee_delete\nPOST employee<../api/dynamics_employee_create>\nPATCH employee<../api/dynamics_employee_update>"}