List workers - Healthier Business Group

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

or

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/v1/workers?regulator=undefined&status=undefined&is_active=undefined&page=undefined' \
--header 'Authorization: Bearer <token>'

Responses

🟢200

application/json

Paginated list of workers

Bodyapplication/json

Example

{
    "data": [
        {
            "id": 101,
            "first_name": "Jane",
            "last_name": "Smith",
            "date_of_birth": "1985-06-15",
            "email": "jane.smith@example.com",
            "phone": "07700900123",
            "regulator": "nmc",
            "registration_number": "SW12345",
            "profession": "Social Worker",
            "current_status": "active",
            "expiry_date": "2027-06-30",
            "restrictions_summary": null,
            "monitoring_start_date": "2026-04-21",
            "check_frequency": "daily",
            "last_checked_at": "2026-04-21T08:30:00+00:00",
            "next_check_due_at": "2026-04-28T08:30:00+00:00",
            "consent_given": true,
            "consent_given_at": "2026-04-21T09:00:00+00:00",
            "is_active": true,
            "notes": "Senior social worker, team lead",
            "created_at": "2026-04-21T09:00:00+00:00",
            "updated_at": "2026-04-21T11:30:00+00:00"
        }
    ],
    "links": {
        "first": "https://ram.test/api/v1/workers?page=1",
        "last": "https://ram.test/api/v1/workers?page=4",
        "prev": null,
        "next": "https://ram.test/api/v1/workers?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 4,
        "per_page": 50,
        "to": 50,
        "total": 187
    }
}

🟠401Unauthorized