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
  • Schemas
    • Booking
    • TokenResponse
    • InterviewBooking
    • Pagination
    • BookingInvite
    • ReferenceRequest
    • BookingsResponse
    • Reference
    • BookingLinksResponse
    • ReferenceDetail
    • CreateReferenceRequest
    • RefereeInput
    • Template
    • WebhookEndpoint
    • CreateWebhookEndpoint
    • UpdateWebhookEndpoint
    • WebhookCall
    • WebhookPayload
    • PaginationMeta
    • PaginationLinks
    • Error
    • RateLimitError
    • ValidationError
  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
Body

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