List a worker's previous employments

GET

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

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

• Production

Returns every previous employment recorded for a worker in your own agency, oldest record first — which is the order they were entered in, not the order the jobs were held. Sort on workFrom if you need the working history in sequence.

The list is not paged. 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

• Bearer

Parameters

Path Parameters

workerId

required

integer format: int32

The workerId path parameter

Responses

200

OK

Media typeapplication/json

Every previous employment recorded for a worker.

object

workerId

The worker the employments belong to.

integer format: int32

previousEmployments

The employments, oldest record first.

Array<object>

A job the worker held before registering, and the reference chased for it.

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

{
  "workerId": 4821,
  "previousEmployments": [
    {
      "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"
}