List a person's employment history
Returns every change to the person's job title, department, position, manager, sites, employment type, contract, contracted hours and grade, and their start and leaving dates, newest first by the day each took effect, a page at a time. Each line says what it was and what it became, in words, with the IDs of a department, position, manager or sites.
Scope: hr:read · Plan: Pro and Enterprise in live mode; every plan in test mode.
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
Admins create keys in Console → Developers → API keys and choose each key's scopes. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: hr:read
person_id*stringThe person's ID.
^person_[0-7][0-9a-hjkmnp-tv-z]{25}$"person_01kjsesxm0e4zbyvkr7bcfxbfg"limit?integerHow many items to return, from 1 to 100.
1 <= value <= 10025cursor?stringThe next_cursor from the previous page. Leave it out for the first page.
length <= 512The person's employment history.
application/json- response
data*array<>next_cursor*|Pass this as cursor to get the next page. null on the last page.
"b3BhcXVlLWN1cnNvcg"has_more*booleancurl -X GET 'https://api.agoohq.com/v1/people/person_01kjsesxm0e4zbyvkr7bcfxbfg/employment-history?limit=25'{ "data": [ { "id": "jobh_01m6j4r8t2v6x0z4b8d2f6h0kn", "object": "employment_history", "person_id": "person_01kjw4mg80efgb5aqbsqnxhtbh", "field": "job_title", "from": "Operations officer", "to": "Senior operations officer", "from_id": null, "to_id": null, "effective_on": "2026-11-01", "source": "change", "change_id": "pchg_01m6j4p2r6t0v4x8z2b6d0f4hm", "recorded_at": "2026-11-01T00:05:00Z" }, { "id": "jobh_01m6j4r8t2v6x0z4b8d2f6h0kp", "object": "employment_history", "person_id": "person_01kjw4mg80efgb5aqbsqnxhtbh", "field": "position", "from": null, "to": "Senior operations officer", "from_id": null, "to_id": "pos_01m6h2k4q8e7r9t1v3w5x7y9za", "effective_on": "2026-11-01", "source": "change", "change_id": "pchg_01m6j4p2r6t0v4x8z2b6d0f4hm", "recorded_at": "2026-11-01T00:05:00Z" }, { "id": "jobh_01m6g0b2d4f6h8k0m2p4r6t8vw", "object": "employment_history", "person_id": "person_01kjw4mg80efgb5aqbsqnxhtbh", "field": "started_on", "from": null, "to": "2021-06-14", "from_id": null, "to_id": null, "effective_on": "2021-06-14", "source": "backfill", "change_id": null, "recorded_at": "2026-10-19T08:00:00Z" } ], "next_cursor": null, "has_more": false}Update a person's HR profile PATCH
Changes the person's personal and employment details. Send only the fields you want to change; `null` clears one. - Job title, department, position, manager, sites, employment type and contracted hours change with a job change (`POST /people/{person_id}/job-changes`), so each has a date and a line of employment history. - `notice_days` is for a notice longer than the one the Labour Act gives (s.17); leave it `null` for the Act's. - `digital_address` must be a GhanaPost GPS address, such as `GA-123-4567`. - `marital_status` is accepted only when your organisation records it, and it and `disability_declared` are kept but never returned through the API. **Scope:** `hr:write` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.
List a person's job changes GET
Returns the person's job changes, newest first (up to 200): waiting for approval (`pending`), `scheduled` for their date, `applied`, `declined`, `cancelled`, or `failed` when one couldn't be made on its date (`failure` says why). **Scope:** `hr:read` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.