Get worker details
const url = 'https://api2.recruso.co.uk/v1/workers/1';const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api2.recruso.co.uk/v1/workers/1 \ --header 'Authorization: <Authorization>'Returns a single worker with their tax details, bank details, compliance documents and job categories. Workers belonging to another agency, or registered against a branch the Recruso user behind your API app cannot access, return 404 rather than 403, so their existence is never disclosed. The same holds for every record a worker holds, on every worker operation.
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 id path parameter
Responses
Section titled “Responses”OK
object
The worker’s surrogate identifier. Use this on subsequent worker endpoints.
The worker’s human-facing reference, allocated from your agency’s own worker number sequence at creation. Unique within the agency, not across the platform.
The branch the worker is registered against. Fixed at registration.
The worker’s title, as an id from the platform Titles vocabulary.
The worker’s first name.
The worker’s family name.
What the worker prefers to be called, when it differs from their forename.
The worker’s initials.
The worker’s date of birth.
The worker’s gender, as an id from the platform Genders vocabulary.
The worker’s marital status, as an id from the platform vocabulary.
The worker’s ethnic origin, as an id from the platform vocabulary.
The worker’s nationality, as an id from the platform Nationalities vocabulary.
The first line of the worker’s home address.
The second line of the worker’s home address.
The town or city of the worker’s home address.
The county of the worker’s home address.
The country of the worker’s home address.
The postcode of the worker’s home address.
The worker’s landline number.
The worker’s mobile number.
The worker’s email address.
Who to contact in an emergency.
The emergency contact’s telephone number.
The emergency contact’s email address.
Whether the worker is flagged Do Not Import.
Whether the worker uses HiWiz.
Whether the worker holds their own safety boots.
Whether the worker holds a digital tachograph card.
Whether the worker has opted out of the Working Time Directive.
Whether the worker is a student.
Whether the worker has asked not to be sent SMS or email.
The worker’s rating, on a 1-10 scale.
The cost centre the worker is booked against.
The worker’s engagement type. Subcontractor types additionally require to be set.
How the worker travels to work.
Where the worker came from, as an id from your agency’s Recruitment sources lookup.
How far the worker is willing to travel, in miles.
The lowest hourly rate the worker will accept.
The lowest daily rate the worker will accept.
The worker’s Home Office right-to-work share code.
The subcontractor the worker is engaged through, when the worker type requires one.
The date the worker was registered, in UK local time. Fixed at registration.
The Recruso user the worker is registered under.
The Recruso user id (tblUsers.UserID) that created the worker, not the ASP.NET Identity id.
When the worker was created, in UK local time.
The Recruso user id (tblUsers.UserID) that last updated the worker, not the ASP.NET Identity id. Null until the worker has been updated.
When the worker was last updated, in UK local time. Null until the worker has been updated.
The worker’s current status. Assigned from the agency default at registration, when one is configured; updating a worker’s details does not change it.
The worker’s tax and payment setup.
object
The worker’s National Insurance number.
The tax form the worker provided. Forms that do not use the starter checklist clear the statement fields below; a form of None or Not Required also overrides .
The worker’s National Insurance category letter.
Starter-checklist statement A: this is their first job since 6 April.
Starter-checklist statement B: this is now their only job. Defaults to true.
Starter-checklist statement C: they have another job or a pension.
The starter-checklist “none of the above” statement.
The worker’s tax code. Falls back to the agency’s default tax code when the request does not supply one.
When true, tax is calculated on a week-1/month-1 basis rather than cumulatively.
How the worker is paid. Every method other than Cheque requires to be present.
How often the worker is paid. New workers default to weekly, and an update keeps whatever they are already on.
Where the worker’s pay is sent. Absent for a worker who has never had an account on file.
object
The kind of account. A building society account additionally requires .
The name the account is held in.
The account number.
The sort code.
The building society name, required for building society accounts.
Free-text notes about the worker. Absent for a worker nobody has written a note about.
object
A short note about the worker.
The work the worker has done before.
General notes.
Why the worker is blacklisted, where a reason has been recorded.
The outcome of assessing the worker.
Notes about when the worker can be booked.
The compliance documents held for the worker. Set at registration; updating a worker’s details leaves them untouched.
A compliance document held for the worker.
object
The record’s identifier.
The kind of document, as an id from your agency’s Compliance lookup.
The date the document takes effect.
The date the document expires.
The vehicle classes the worker is licensed to drive, as ids from the platform Vehicle categories vocabulary.
Sites the worker is approved to work at.
Sites the worker is not to be sent to.
Sites the worker has been assessed at.
Sites that have banned the worker.
The job categories the worker can be booked for.
A job category the worker can be booked for.
object
The record’s identifier. Stable across updates that keep the category.
The job category, as an id from your agency’s Job categories lookup.
Whether this is the worker’s default category — the first one sent on a write.
Example
{ "workerId": 4821, "workerNumber": 10432, "branchId": 4, "titleId": 2, "forename": "Alice", "surname": "Baker", "knownAs": "Ali", "initials": "AB", "birthDate": "1990-04-12", "genderId": 2, "maritalStatusId": 1, "ethnicOriginId": 3, "nationalityId": 14, "address1": "12 High Street", "address2": "Flat 2", "town": "Manchester", "county": "Greater Manchester", "country": "United Kingdom", "postalCode": "M1 1AA", "telephone1": "0161 496 0123", "mobile": "07700 900123", "email": "alice.baker@example.co.uk", "nextOfKinFullName": "Jane Baker", "nextOfKinContactNumber": "07700 900456", "nextOfKinEmailAddress": "jane.baker@example.co.uk", "dni": false, "hiWiz": false, "safetyBoots": true, "digitalTacho": false, "wtdOptout": false, "isStudent": false, "canNotSendSmsEmail": false, "workerRating": 8, "costCentreId": 3, "workerTypeId": 1, "transportId": 2, "recruitmentSourceId": 6, "workRadius": 25, "minimumHourlyRate": 12.21, "minimumDailyRate": 97.68, "rtwShareCode": "W3K 9QP 7ZB", "subContractorId": 55, "registeredDate": "2026-08-14", "userId": 100, "createdBy": 100, "createdOn": "2026-08-14T09:41:02", "modifiedBy": 100, "modifiedOn": "2026-09-02T15:08:47", "workerStatusTypeId": 3, "taxDetails": { "niNumber": "AB123456C", "formId": 1, "niCategoryId": 1, "statementA": true, "statementB": false, "statementC": false, "noStatement": false, "employeeTaxCode": "1257L", "week1BasisFlag": false, "paymentMethodId": 1, "paymentFrequencyId": 1 }, "bankDetails": { "bankAccountTypeId": 1, "accountName": "A Baker", "accountNumber": "12345678", "sortCode": "01-02-03", "buildingSoc": "Skipton" }, "additionalDetails": { "memo": "Prefers early shifts; will travel to Salford at short notice.", "experience": "Three years warehouse picking, counterbalance FLT since 2023.", "notes": "Registered in branch; documents seen in person.", "blacklistReason": "Left a shift without notice at Trafford Park, 14 August 2026.", "assessment": "Assessed on counterbalance FLT 12 May 2026 — competent, no retraining needed.", "bookingAvailabilityNotes": "Not available Thursdays; college day." }, "compliances": [ { "workerComplianceId": 7311, "complianceId": 3, "startDate": "2026-01-15", "endDate": "2031-01-14" } ], "jobCategories": [ { "workerJobCategoryId": 9014, "jobCategoryId": 27, "isDefault": true } ]}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"}