Healthier Business Group
Home
HB PortalRequest API access
Home
HB PortalRequest API access
X
Instagram
LinkedIn
  1. Candidate Requests
  • Walk through Healthier Business Group 🔵
  • Heathier Business Portal APIs V2
    • Authentication
      • Get access token
      • Refresh access token
      • Get token info
      • Revoke current token
    • Reference Requests
      • References
        • Get reference detail
        • Download reference PDF
      • List reference requests
      • Create reference request
      • Get reference request
      • Cancel reference request
      • Add referee to request
      • Send reminders
    • Candidate Requests
    • Training Requests
    • OH Requests
    • Practical Training Requests
    • BLS Requests
    • Appraisal Requests
    • Certificate Requests
    • Training Verification Requests
    • Webhooks
      • List webhook endpoints
      • Create webhook endpoint
      • Update webhook endpoint
      • Delete webhook endpoint
      • View webhook call logs
      • Send test webhook
    • Templates
      • List form templates
  • Heathier Business Portal APIs V1 - Deprecated
    • Candidate Requests
      • Get All Candidates
        GET
      • Get Candidate Data
        GET
      • Create New Candidate
        POST
      • Update Candidate Details
        PATCH
    • Training Requests
      • Get Available Trainings
      • Get Candidate Course Result
      • Get Candidate Training Report
      • Get Candidate Training Report - Unassigned
    • OH Requests
      • Get Available Forms
      • Get Form Fields
      • Creating a new submission
      • Modifying the details of an existing submission (Upload Documents)
      • Make final form submission (after uploading documents)
      • Get submission list
      • Retrieve submission result details
      • Retrieve the submission result documents for the employer
    • Certificates Requests
      • Get Training Certificate
      • Get Training Certificate - including expired
      • Get Training Certificate - including non-assigned courses, but excluding expired
      • Get Training Certificate - All available courses
      • Get Training Certificate - Specific Course
    • Webhooks
      • Training Completion
      • Course Completion
  • HB Services
    • List Interview Bookings
      GET
  • The Direct Training Academy
    • Bookings
      • Get Past Bookings
      • Get Upcoming Bookings
      • Search Bookings by Date
    • Booking Links
      • Search Booking Links
  • Registration Assurance Monitoring Portal
    • Authentication
      • Obtain access token
      • Refresh access token
      • Get token info
      • Revoke current token
    • Workers
      • List workers
      • Create worker
      • Get worker
      • Update worker
      • Partially update worker
      • Delete worker
    • Verification
      • Verify single worker
      • Get worker verification history
      • Batch verify all workers
      • Get verification job status
    • Alerts
      • List alerts
      • Get alert
      • Acknowledge single alert
      • Acknowledge alerts in bulk
    • Monitoring
      • Update worker monitoring settings
      • Bulk update monitoring settings
    • Evidence
      • List worker evidence files
      • Get evidence metadata
      • Download evidence file
    • Billing
      • Get billing and usage summary
    • Imports
      • List worker imports
      • Upload worker CSV import
      • Get worker import status
    • Team
      • List available team roles
      • List team users
      • Create team user
      • Get team user
      • Update team user
      • Delete team user
    • Webhooks
      • List webhook endpoints
      • Create webhook endpoint
      • Get webhook endpoint
      • Update webhook endpoint
      • Delete webhook endpoint
      • Rotate webhook secret
      • Queue test webhook delivery
  • Schemas
    • TokenRequest
    • Booking
    • InterviewBooking
    • TokenResponse
    • Pagination
    • RefreshRequest
    • ReferenceRequest
    • BookingInvite
    • Reference
    • BookingsResponse
    • ReferenceDetail
    • TokenInfo
    • BookingLinksResponse
    • CreateReferenceRequest
    • Worker
    • RefereeInput
    • WorkerResponse
    • Template
    • WorkerPaginatedResponse
    • WebhookEndpoint
    • StoreWorkerRequest
    • CreateWebhookEndpoint
    • UpdateWorkerRequest
    • VerificationCheck
    • UpdateWebhookEndpoint
    • WebhookCall
    • VerificationCheckPaginatedResponse
    • WebhookPayload
    • VerifyQueuedResponse
    • PaginationMeta
    • VerifyBatchResponse
    • PaginationLinks
    • VerificationJobStatus
    • Error
    • Alert
    • RateLimitError
    • AlertPaginatedResponse
    • MessageResponse
    • BulkAcknowledgeAlertsRequest
    • ValidationError
    • ValidationErrorResponse
    • AcknowledgeCountResponse
    • UpdateMonitoringSettingsRequest
    • BulkUpdateMonitoringSettingsRequest
    • EvidenceFile
    • EvidenceFilePaginatedResponse
    • BillingUsageResponse
    • StoreWorkerImportRequest
    • WorkerImport
    • WorkerImportPaginatedResponse
    • TeamUser
    • TeamUserPaginatedResponse
    • StoreTeamUserRequest
    • UpdateTeamUserRequest
    • WebhookEndpointPaginatedResponse
    • StoreWebhookEndpointRequest
    • UpdateWebhookEndpointRequest
    • CreateWebhookEndpointResponse
    • RotateWebhookSecretResponse
    • WebhookTestRequest
    • WebhookTestQueuedResponse
    • WebhookEventStatusChanged
    • WebhookEventInitialVerification
  1. Candidate Requests

Get All Candidates

GET
/candidates
Maintainer:Not configured
This endpoint retrieves a list of all non-archived candidates.
The URI format is: https://hb-host.tld/api/candidates/
The request is HTTP GET (RFC2616).

Request

Authorization
Add parameter in header
API-Key
Example:
API-Key: ********************
Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/candidates' \
--header 'Accept: application/json' \
--header 'API-Version: {{api_version}}' \
--header 'API-Key: <api-key>' \
--data-urlencode 'per_page=10'

Responses

🟢200Get All Candidates
application/json
Bodyapplication/json

Example
[
    {
        "candidates": [
            {
                "candidate_ref": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "candidate_id": "0000000",
                "client_record_ref": "",
                "first_name": "first_name",
                "last_name": "last_name",
                "email": "email@domain.co.uk",
                "candidate_status": "activated",
                "date_registered": "2017-03-31 14:08:27",
                "last_login_date": "2023-05-19 08:11:16",
                "renewal_date": "2019-06-12 09:07:52",
                "assigned_course_count": "68",
                "completed_course_count": "9",
                "renewal_due_count": "0",
                "expired_course_count": "5",
                "renew_training": "0"
            },
            {
                "candidate_ref": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "candidate_id": "0000000",
                "client_record_ref": "",
                "first_name": "first_name",
                "last_name": "last_name",
                "email": "email@domain.co.uk",
                "candidate_status": "activated",
                "date_registered": "2017-09-04 10:55:37",
                "last_login_date": "2018-05-14 10:12:19",
                "renewal_date": "2020-08-15 10:04:47",
                "assigned_course_count": "21",
                "completed_course_count": "0",
                "renewal_due_count": "0",
                "expired_course_count": "19",
                "renew_training": "0"
            }
        ]
    }
]
Modified at 2024-08-09 12:11:06
Previous
List form templates
Next
Get Candidate Data
Built with