Get one of a worker's previous employments

GET

/v1/workers/{workerId}/previous-employments/{id}

curl --request GET \
  --url https://api2.recruso.co.uk/v1/workers/1/previous-employments/1 \
  --header 'Authorization: <Authorization>'

• Production

Returns a single previous employment recorded for a worker in your own agency, with the state of the reference chased for it.

A record that belongs to a different worker, or to another agency, returns 404 rather than 403, so its existence is never disclosed.

Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.

Authorizations

• Bearer

Parameters

Path Parameters

workerId

required

integer format: int32

The workerId path parameter

id

required

integer format: int32

The id path parameter

Responses

200

OK

Media typeapplication/json

object

previousEmploymentId

The record’s identifier.

integer format: int32

clientName

The employer’s name.

string

companyRegNumber

The employer’s company registration number.

string

telephone

A telephone number for the employer.

string

nullable

fax

A fax number for the employer.

string

nullable

email

An email address for the employer.

string

nullable

workerPosition

The job the worker did there.

string

nullable

contactPersonName

Who to ask for a reference.

string

nullable

contactPersonPosition

That person’s job.

string

nullable

reasonForLeft

Why the worker left.

string

nullable

experience

What the worker did there.

string

nullable

workFrom

The date the worker started there.

string format: date

nullable

workTo

The date the worker left.

string format: date

nullable

honest

Whether the reference described the worker as honest.

boolean

nullable

reEmploy

Whether the employer said they would re-employ the worker.

boolean

nullable

abilityRank

How the reference graded the worker’s ability, from 0 to 5 inclusive. Null when the reference did not grade them.

integer format: uint8

nullable

timeKeepingRank

How the reference graded the worker’s time keeping, from 0 to 5 inclusive. Null when the reference did not grade them.

integer format: uint8

nullable

referenceSentDate

The date the reference request was sent.

string format: date

nullable

referenceOutcome

What came back.

string

nullable

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"
}

401

Unauthorized

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Forbidden

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Not Found

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}