List a worker's documents
const url = 'https://api2.recruso.co.uk/v1/workers/1/documents';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/documents \ --header 'Authorization: <Authorization>'Returns the files held against a worker in your own agency, most recently uploaded first.
Each entry says what the file was called, when it was uploaded and who uploaded it. The files themselves cannot be downloaded through the API. 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
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The workerId path parameter
Responses
Section titled “Responses”OK
The files held against a worker.
object
The worker the documents belong to.
The documents, most recently uploaded first.
One file held against a worker.
object
The document’s identifier.
The name the file was uploaded as.
The Recruso user id (tblUsers.UserID) that uploaded it, not the ASP.NET Identity id.
When it was uploaded, in UK local time.
Example
{ "workerId": 4821, "documents": [ { "workerDocumentId": 7714, "documentName": "New Microsoft Word Document.docx", "createdBy": 100, "createdOn": "2026-09-07T11:04:22" } ]}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"}