v1

latestOpenAPI 3.0.12026-07-268028223.9 KB

People

Create an employment for a person

Add a new employment record to an existing person

post/v1/people/{person_id}/employments

Request body

business_namestring required

rolestring

start_datestring date

end_datestring date

actively_employedboolean

Example request

{
  "business_name": "Acme Corp",
  "role": "Software Engineer",
  "start_date": "2023-01-15",
  "end_date": "2024-12-31",
  "actively_employed": true
}

Response

employment created

idstring

The employment ID

person_idstring

The person ID

business_namestring required

rolestring nullable

start_datestring date nullable

end_datestring date nullable

actively_employedboolean

Example response

{
  "id": "emp123xyz",
  "person_id": "abc123xyz",
  "business_name": "Acme Corp",
  "role": "Software Engineer",
  "start_date": "2023-01-15",
  "end_date": "2024-12-31",
  "actively_employed": true
}