Retrieve the properties and relationships of an employee object for Business Central.
HTTP request
Replace the URL prefix for Business Central depending on environment following the guideline.
GET businesscentralPrefix/companies({id})/employees({id})
Request headers (v1.0)
| Header | Value |
|---|---|
| Authorization | Bearer {token}. Required. |
Request body (v1.0)
Do not supply a request body for this method.
Response (v1.0)
If successful, this method returns a 200 OK response code and an employees object in the response body.
Request
Here is an example of the request.
GET https://{businesscentralPrefix}/api/v1.0/companies({id})/employees({id})
Response
Here is an example of the response.
Note
The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
{
"id": "id-value",
"number": "AH",
"displayName": "Annette Hill",
"givenName": "Annette",
"middleName": "",
"surname": "Hill",
"jobTitle": "Secretary",
"address": {
"street": "677 Fifth Avenue",
"city": "New York",
"state": "",
"countryLetterCode": "",
"postalCode": "10022"
},
"phoneNumber": "4465-4899-4643",
"mobilePhone": "4564-4564-7831",
"email": "",
"personalEmail": "ah@cronus-demosite.com",
"employmentDate": "2001-06-01",
"terminationDate": "0001-01-01",
"status": "Active",
"birthDate": "1973-12-12",
"picture@odata.mediaReadLink": "https://api.financials.dynamics.com/v1.0/api/v1.0/companies({id})/employees({id})/picture",
"lastModifiedDateTime": "2017-03-16T14:57:19.497Z"
}
Related information
Tips for working with the APIs
Error Codes
Employee
Post Employee
Patch Employee
Delete Employee