GET /workers/{id}

Summary

Get worker

URL Parameters

Name	Type	Required	Description
id	string	Yes	Worker identifier

Query Parameters

Name	Type	Required	Description
includeDocumentValidations	boolean	No	If true, include matching competency-validation rows for each document in attachments and rightToWork. Non-system validations are limited to companies linked to the API key.

Request Body Fields

No request body is accepted for this endpoint.

Request Example

cURL

curl -X GET 'https://api.requidex.com/api/open/v1/workers/{id}?includeDocumentValidations=true' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

const response = await fetch(
  "https://api.requidex.com/api/open/v1/workers/{id}?includeDocumentValidations=true",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer <API_KEY>",
      Accept: "application/json",
    },
  }
);

const json = await response.json();

Response Fields

Field	Type	Description
id	string	Worker id
reference	string	Worker reference
firstName	string	Worker first name
lastName	string	Worker last name
name	string	Worker full name
gender	string	Worker gender
nationalIns	string	National Insurance number
passportNo	string	Passport number
nationality	string	Nationality
dob	string	Date of birth in ISO 8601 date-time format
phone	object	Show child attributes countryCode string - Country dialing code number string - Phone number
email	string	Worker email
address	object	Show child attributes lineOne string - Address line one lineTwo string - Address line two city string - City region string - Region country string - Country code string - Postal code latitude number - Latitude longitude number - Longitude formattedAddress string - Full formatted address
agencies	array[object]	Show child attributes id string - Agency id name string - Agency name agencyId string - Agency-specific worker identifier active boolean - Whether the worker is active for this agency link
trades	array[object]	Show child attributes id string - Trade id name string - Trade name
attachments	array[object]	Show child attributes id string - Worker document id type string - Document collection name documentType string - Document type label documentNumber string - Document number expiration string - Expiration timestamp, when present indefinite boolean - Whether the document has no expiry date createdAt string - Timestamp when the document was added files array[object] - Show child attributes fileName string - Document file name url string - Public file URL docType string - File role within the document set verification object - CSCS Smart Check verification details when available. Show child attributes verified boolean - Whether the document passed CSCS Smart Check cardTypeName string - Verified card type name serial string - Card serial number customerName string - Cardholder name returned by Smart Check documentNumber string - Verified card number photoType string - Cardholder photo content type expiry string - Verified expiry value occupationQualifications array[object] - Occupation qualifications returned by Smart Check (qual) lastVerifiedAt string - Timestamp of the latest Smart Check result systemValidation object - Show child attributes status string - System validation status checkedAt string - Timestamp of the system validation result documentType string - Document type evaluated by the system validator reason string - System validation failure reason, when present validations array[object] - Returned only when includeDocumentValidations=true. Non-system rows are limited to companies linked to the API key. Show child attributes id string - Validation id company object - Show child attributes id string - Company id name string - Company name competency object - Show child attributes id string - Competency id name string - Competency name user object - Show child attributes id string - User id name string - User name validationType string - Validation source type status string - Validation status, when present invalidReason string - Invalidation reason code, when present invalidReasonText string - Additional invalidation notes, when present resolvedAt string - Timestamp when the validation was resolved, when present documentType string - Document type recorded on the validation row, when present documentRef string - Candidate document id referenced by the validation, when present statusHistory array[object] - Show child attributes status string - Validation status recorded for the history entry invalidReason string - Invalidation reason code, when present invalidReasonText string - Additional invalidation notes, when present changedAt string - Timestamp when the history entry was recorded changedBy object - User reference for the change (id, name) createdAt string - Validation creation timestamp updatedAt string - Validation update timestamp
rightToWork	array[object]	Show child attributes id string - Worker document id type string - Document collection name documentType string - Document type label documentNumber string - Document number expiration string - Expiration timestamp, when present indefinite boolean - Whether the document has no expiry date createdAt string - Timestamp when the document was added files array[object] - Show child attributes fileName string - Document file name url string - Public file URL docType string - File role within the document set systemValidation object - Show child attributes status string - System validation status checkedAt string - Timestamp of the system validation result documentType string - Document type evaluated by the system validator reason string - System validation failure reason, when present validations array[object] - Returned only when includeDocumentValidations=true. Non-system rows are limited to companies linked to the API key. Show child attributes id string - Validation id company object - Show child attributes id string - Company id name string - Company name competency object - Show child attributes id string - Competency id name string - Competency name user object - Show child attributes id string - User id name string - User name validationType string - Validation source type status string - Validation status, when present invalidReason string - Invalidation reason code, when present invalidReasonText string - Additional invalidation notes, when present resolvedAt string - Timestamp when the validation was resolved, when present documentType string - Document type recorded on the validation row, when present documentRef string - Candidate document id referenced by the validation, when present statusHistory array[object] - Show child attributes status string - Validation status recorded for the history entry invalidReason string - Invalidation reason code, when present invalidReasonText string - Additional invalidation notes, when present changedAt string - Timestamp when the history entry was recorded changedBy object - User reference for the change (id, name) createdAt string - Validation creation timestamp updatedAt string - Validation update timestamp
createdAt	string	Creation timestamp in ISO 8601 date-time format
updatedAt	string	Last update timestamp in ISO 8601 date-time format

Response Example (200)

{
  "success": true,
  "data": {
    "id": "67bc36db80a1616ec3f48999",
    "reference": "WK-1001",
    "firstName": "Jordan",
    "lastName": "Smith",
    "name": "Jordan Smith",
    "gender": "male",
    "nationalIns": "AB123456C",
    "passportNo": "P1234567",
    "nationality": "British",
    "dob": "1990-01-01T00:00:00.000Z",
    "phone": {
      "countryCode": "+44",
      "number": "1234567890"
    },
    "email": "jordan@example.com",
    "address": {
      "lineOne": "1 Main Street",
      "city": "Manchester",
      "country": "United Kingdom",
      "code": "M1 1AA"
    },
    "agencies": [
      {
        "id": "67bc36db80a1616ec3f47101",
        "name": "Northline Labour Desk",
        "agencyId": "AG-1001",
        "active": true
      }
    ],
    "trades": [
      {
        "id": "67bc36db80a1616ec3f47102",
        "name": "Electrician"
      }
    ],
    "attachments": [
      {
        "id": "67bc36db80a1616ec3f48a10",
        "type": "attachment",
        "documentType": "CSCS Card",
        "documentNumber": "CSCS-123",
        "expiration": "2027-01-01T00:00:00.000Z",
        "indefinite": false,
        "createdAt": "2026-02-01T09:00:00.000Z",
        "files": [
          {
            "fileName": "cscs-front.jpg",
            "url": "https://files.requidex.com/cscs-front.jpg",
            "docType": "Front"
          }
        ],
        "verification": {
          "verified": true,
          "cardTypeName": "Gold Skilled Worker",
          "serial": "CSCS-SERIAL-1",
          "customerName": "Jordan Smith",
          "documentNumber": "CSCS-123",
          "photoType": "image/jpeg",
          "expiry": "2027-01-01",
          "occupationQualifications": [
            {
              "qual": "Electrician"
            }
          ],
          "lastVerifiedAt": "2026-02-02T12:00:00.000Z"
        },
        "systemValidation": {
          "status": "validated",
          "checkedAt": "2026-02-02T12:00:00.000Z",
          "documentType": "CSCS Card",
          "reason": null
        },
        "validations": [
          {
            "id": "67bc36db80a1616ec3f48b01",
            "company": {
              "id": "67bc36db80a1616ec3f47001",
              "name": "Requidex Construction Ltd"
            },
            "competency": {
              "id": "67bc36db80a1616ec3f47234",
              "name": "CSCS"
            },
            "user": {
              "id": "67bc36db80a1616ec3f49998",
              "name": "Alex Carter"
            },
            "validationType": "manual",
            "status": "validated",
            "resolvedAt": "2026-02-05T12:00:00.000Z",
            "documentType": "attachment",
            "documentRef": "67bc36db80a1616ec3f48a10",
            "statusHistory": [
              {
                "status": "validated",
                "changedAt": "2026-02-05T12:00:00.000Z",
                "changedBy": {
                  "id": "67bc36db80a1616ec3f49998",
                  "name": "Alex Carter"
                }
              }
            ],
            "createdAt": "2026-02-05T12:00:00.000Z",
            "updatedAt": "2026-02-05T12:00:00.000Z"
          }
        ]
      }
    ],
    "rightToWork": [
      {
        "id": "67bc36db80a1616ec3f48a11",
        "type": "rightToWork",
        "documentType": "Passport",
        "documentNumber": "P1234567",
        "expiration": "2028-01-01T00:00:00.000Z",
        "indefinite": false,
        "createdAt": "2026-02-03T09:00:00.000Z",
        "files": [
          {
            "fileName": "passport-front.jpg",
            "url": "https://files.requidex.com/passport-front.jpg",
            "docType": "Front"
          }
        ],
        "systemValidation": {
          "status": "validated",
          "checkedAt": "2026-02-04T12:00:00.000Z",
          "documentType": "Passport",
          "reason": null
        }
      }
    ],
    "createdAt": "2026-01-15T10:00:00.000Z",
    "updatedAt": "2026-02-10T14:00:00.000Z"
  }
}

Errors

HTTP Status	Description
400	Missing worker id
401	Missing, invalid, revoked, or expired API key
404	Worker not found
405	Method not allowed on Open API routes
429	Rate limit exceeded
500	Unexpected internal error