An employee can hold one or more positions, and optionally, payments and working time can be held against an employee position, rather than directly as an attribute of the employment record. This means that potentially, an employee can hold more than one position, with working time and payments being held separately for each position
Get Employment Position by Employment ID
Get Employment Position by Employment ID
SecuritybearerAuth
Request
Responses
200
Employee Position Response
400
Bad Request
401
Unauthorized - Authorization Required
404
Not Found
422
Unprocessable Entity
default
General Error
get/employeePositions/{id}
Request samples
- curl
- C#
- Java
- PHP
Response samples
- 200
- 400
- 401
- 404
- 422
- default
application/vnd.api+json
{- "data": {
- "0": {
- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}, - "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "employment": {
- "links": {
}
}, - "lineManager": {
- "links": {
- "data": {
- "type": "employments",
- "id": "322f1e59-573d-1d93-7c01-3b6303abe9be"
}
}
}, - "organisationUnit": {
- "links": {
}
}
}, - "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}
}Add or update an employment position
Add or update an employment position
SecuritybearerAuth
Request
Request Body schema: application/vnd.api+json
Employee position to be added or updated
object |
Responses
200
Employee Position Response
400
Bad Request
401
Unauthorized - Authorization Required
422
Unprocessable Entity
default
General Error
post/employeePositions
Request samples
- Payload
- curl
- C#
- Java
- PHP
application/vnd.api+json
{- "data": {
- "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "0": null,
- "employment": {
- "data": {
- "id": "906264f1-2dff-4f72-a10b-59918cf738d7",
- "type": "employments"
}
}, - "lineManager": {
- "data": {
- "id": "4b30b724-26e1-4fcb-90f0-92936523133c",
- "type": "employments"
}
}, - "organisationUnit": {
- "data": {
- "id": "285f0a36-9ff3-4399-a47a-80e9bce56921",
- "type": "organisationUnits"
}
}
}
}
}Response samples
- 200
- 400
- 401
- 422
- default
application/vnd.api+json
{- "data": {
- "0": {
- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}, - "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "employment": {
- "links": {
}
}, - "lineManager": {
- "links": {
- "data": {
- "type": "employments",
- "id": "322f1e59-573d-1d93-7c01-3b6303abe9be"
}
}
}, - "organisationUnit": {
- "links": {
}
}
}, - "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03"
}
}