List Workers

GET/workers

Caller

Company

Company-scoped API keys can filter workers by company and optionally include document validation rows.

Agency

Agency-scoped API keys return workers represented by the calling agency.

Summary

Returns a paginated list of workers available to the API key, with company, search, creation date, document expiry, field selection, and sorting controls.

URL Parameters

• None

Query Parameters

Company

Name	Type	Required	Description
company	string	No	Filter by company id(s). Pass a single id or comma-separated ids. If omitted, workers for all companies linked to the API key are returned.
page	integer	No	Page number (default 1)
limit	integer	No	Records per page (default 50, max 200)
query	string	No	Case-insensitive search against worker name, reference, and email
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.
expiringAfter	string	No	Return workers with at least one attachments or rightToWork document expiring on or after this date (YYYY-MM-DD)
expiringBefore	string	No	Return workers with at least one attachments or rightToWork document expiring on or before this date (YYYY-MM-DD)
from	string	No	Created date filter start (YYYY-MM-DD)
to	string	No	Created date filter end (YYYY-MM-DD)
sortBy	enum(createdAt, updatedAt, name, firstName, lastName, ref)	No	Sort field
sortOrder	enum(asc, desc)	No	Sort direction
fields	string	No	Comma-separated list of response fields or dot-path nested fields to return

Agency

Name	Type	Required	Description
page	integer	No	Page number (default 1)
limit	integer	No	Records per page (default 50, max 200)
query	string	No	Case-insensitive search against worker name, reference, and email
expiringAfter	string	No	Return workers with at least one visible attachments or rightToWork document expiring on or after this date (YYYY-MM-DD)
expiringBefore	string	No	Return workers with at least one visible attachments or rightToWork document expiring on or before this date (YYYY-MM-DD)
from	string	No	Created date filter start (YYYY-MM-DD)
to	string	No	Created date filter end (YYYY-MM-DD)
sortBy	enum(createdAt, updatedAt, name, firstName, lastName, ref)	No	Sort field
sortOrder	enum(asc, desc)	No	Sort direction
fields	string	No	Comma-separated list of response fields or dot-path nested fields to return

Request Example

Company

cURL

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

JavaScript

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

const json = await response.json();

Agency

cURL

curl -X GET 'https://api.requidex.com/api/open/v1/workers' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

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

const json = await response.json();

Response Fields

Company

Field	Type	Description
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
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
createdAt	string	Creation timestamp in ISO 8601 date-time format
dob	string	Date of birth in ISO 8601 date-time format
email	string	Worker email
firstName	string	Worker first name
gender	string	Worker gender
id	string	Worker id
lastName	string	Worker last name
name	string	Worker full name
nationality	string	Nationality
phone	object	Show child attributes countryCode string - Country dialing code number string - Phone number
reference	string	Worker reference
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
trades	array[object]	Show child attributes id string - Trade id name string - Trade name
updatedAt	string	Last update timestamp in ISO 8601 date-time format

Agency

The response shape matches the company caller response, except attachments[].validations and rightToWork[].validations are not returned for agency-scoped API keys.

Response Example (200)

Company

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f48999",
      "reference": "WK-1001",
      "firstName": "Jordan",
      "lastName": "Smith",
      "name": "Jordan Smith",
      "gender": "male",
      "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
          },
          "validations": [
            {
              "id": "67bc36db80a1616ec3f48b02",
              "company": {
                "id": "67bc36db80a1616ec3f47001",
                "name": "Requidex Construction Ltd"
              },
              "competency": null,
              "user": {
                "id": "67bc36db80a1616ec3f49997",
                "name": "Pat Taylor"
              },
              "validationType": "manual",
              "status": "validated",
              "resolvedAt": "2026-02-06T12:00:00.000Z",
              "documentType": "rightToWork",
              "documentRef": "67bc36db80a1616ec3f48a11",
              "statusHistory": [],
              "createdAt": "2026-02-06T12:00:00.000Z",
              "updatedAt": "2026-02-06T12:00:00.000Z"
            }
          ]
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-02-10T14:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1
  }
}

Agency

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f48999",
      "reference": "WK-1001",
      "firstName": "Jordan",
      "lastName": "Smith",
      "name": "Jordan Smith",
      "gender": "male",
      "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
          }
        }
      ],
      "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"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1
  }
}

MCP Tool

The MCP server exposes this operation as open_api_list_workers with the inputs company, page, limit, query, includeDocumentValidations, expiringAfter, expiringBefore, from, to, sortBy, sortOrder, and fields.

Errors

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