Add a previous employment to a worker
const url = 'https://api2.recruso.co.uk/v1/workers/1/previous-employments';const options = { method: 'POST', headers: {Authorization: '<Authorization>', 'Content-Type': 'application/json'}, body: '{"workerId":4821,"clientName":"Northgate Logistics Ltd","companyRegNumber":"04512339","telephone":"0161 496 0142","fax":"0161 496 0143","email":"hr@northgate-logistics.example.co.uk","workerPosition":"Warehouse operative","contactPersonName":"Priya Raval","contactPersonPosition":"Shift manager","reasonForLeft":"Site closed","experience":"Picking and packing, plus counterbalance FLT from 2023.","workFrom":"2022-04-04","workTo":"2025-11-28","honest":true,"reEmploy":true,"abilityRank":4,"timeKeepingRank":5,"referenceSentDate":"2026-01-06","referenceOutcome":"Received 14 January 2026, satisfactory"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api2.recruso.co.uk/v1/workers/1/previous-employments \ --header 'Authorization: <Authorization>' \ --header 'Content-Type: application/json' \ --data '{ "workerId": 4821, "clientName": "Northgate Logistics Ltd", "companyRegNumber": "04512339", "telephone": "0161 496 0142", "fax": "0161 496 0143", "email": "hr@northgate-logistics.example.co.uk", "workerPosition": "Warehouse operative", "contactPersonName": "Priya Raval", "contactPersonPosition": "Shift manager", "reasonForLeft": "Site closed", "experience": "Picking and packing, plus counterbalance FLT from 2023.", "workFrom": "2022-04-04", "workTo": "2025-11-28", "honest": true, "reEmploy": true, "abilityRank": 4, "timeKeepingRank": 5, "referenceSentDate": "2026-01-06", "referenceOutcome": "Received 14 January 2026, satisfactory" }'Records a job a worker in your own agency held before registering, together with the reference chased for it.
ClientName and CompanyRegNumber are required — both are NOT NULL in the record. WorkTo must not be before WorkFrom. Everything about the reference — when it was sent, what came back, whether the employer would re-employ — is optional, because it arrives after the employment itself is recorded.
Employments accumulate: a worker has as many as they have had jobs, and nothing here rejects two records for the same employer.
A worker id belonging to another agency returns 404 rather than 403, so their existence is never disclosed.
Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The workerId path parameter
Request Bodyrequired
Section titled “Request Bodyrequired”A previous employment to record for a worker.
object
The worker the employment belongs to. Taken from the route; a value in the request body is ignored.
Example
4821The employer’s name, up to 100 characters. Required.
Example
Northgate Logistics LtdThe employer’s company registration number, up to 20 characters. Required.
Example
04512339A telephone number for the employer, up to 20 characters.
Example
0161 496 0142A fax number for the employer, up to 20 characters.
Example
0161 496 0143An email address for the employer, up to 250 characters.
Example
hr@northgate-logistics.example.co.ukThe job the worker did there, up to 50 characters.
Example
Warehouse operativeWho to ask for a reference, up to 50 characters.
Example
Priya RavalThat person’s job, up to 50 characters.
Example
Shift managerWhy the worker left, up to 255 characters.
Example
Site closedWhat the worker did there, up to 350 characters.
Example
Picking and packing, plus counterbalance FLT from 2023.The date the worker started there.
Example
2022-04-04The date the worker left. Must not be before the start date.
Example
2025-11-28Whether the reference described the worker as honest.
Example
trueWhether the employer said they would re-employ the worker.
Example
trueHow the reference graded the worker’s ability, from 0 to 5 inclusive. Leave it out when the reference did not grade them.
Example
4How the reference graded the worker’s time keeping, from 0 to 5 inclusive. Leave it out when the reference did not grade them.
Example
5The date the reference request was sent.
Example
2026-01-06What came back, up to 150 characters.
Example
Received 14 January 2026, satisfactoryResponses
Section titled “Responses”Created
object
The record’s identifier.
The employer’s name.
The employer’s company registration number.
A telephone number for the employer.
A fax number for the employer.
An email address for the employer.
The job the worker did there.
Who to ask for a reference.
That person’s job.
Why the worker left.
What the worker did there.
The date the worker started there.
The date the worker left.
Whether the reference described the worker as honest.
Whether the employer said they would re-employ the worker.
How the reference graded the worker’s ability, from 0 to 5 inclusive. Null when the reference did not grade them.
How the reference graded the worker’s time keeping, from 0 to 5 inclusive. Null when the reference did not grade them.
The date the reference request was sent.
What came back.
Example
{ "previousEmploymentId": 6602, "clientName": "Northgate Logistics Ltd", "companyRegNumber": "04512339", "telephone": "0161 496 0142", "fax": "0161 496 0143", "email": "hr@northgate-logistics.example.co.uk", "workerPosition": "Warehouse operative", "contactPersonName": "Priya Raval", "contactPersonPosition": "Shift manager", "reasonForLeft": "Site closed", "experience": "Picking and packing, plus counterbalance FLT from 2023.", "workFrom": "2022-04-04", "workTo": "2025-11-28", "honest": true, "reEmploy": true, "abilityRank": 4, "timeKeepingRank": 5, "referenceSentDate": "2026-01-06", "referenceOutcome": "Received 14 January 2026, satisfactory"}Bad Request
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Unauthorized
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Forbidden
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Not Found
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}