Healthier Business Group
Home
HB PortalRequest API access
Home
HB PortalRequest API access
X
Instagram
LinkedIn
  1. OH 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 Candidate Data
      • Create New Candidate
      • Update Candidate Details
    • Training Requests
      • Get Available Trainings
      • Get Candidate Course Result
      • Get Candidate Training Report
      • Get Candidate Training Report - Unassigned
    • OH Requests
      • Get Available Forms
        GET
      • Get Form Fields
        GET
      • Creating a new submission
        POST
      • Modifying the details of an existing submission (Upload Documents)
        PATCH
      • Make final form submission (after uploading documents)
        POST
      • Get submission list
        GET
      • Retrieve submission result details
        GET
      • Retrieve the submission result documents for the employer
        GET
    • 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. OH Requests

Get Available Forms

GET
/forms-list
Maintainer:Not configured
The endpoint provides a method to retrieve the list of forms provided by the authenticated client. The requests are HTTP GET (RFC2616) and uses api key as a resource identifier identifying the
client uniquely at HB.
If there’s no forms assigned to your account, the API should send an HTTP 204 No Content response.

Request

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

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 '/forms-list' \
--header 'API-Version: {{api_version}}' \
--header 'API-Key: <api-key>'

Responses

⚪0Get Available Forms
application/json
Body

Example
{
    "count": 3,
    "forms": [
        {
            "form_id": "XX",
            "form_type": "XX",
            "form_name": "Annual Occupational Health"
        },
        {
            "form_id": "XX",
            "form_type": "XX",
            "form_name": "Clinical Occupational Health"
        },
        {
            "form_id": "XX",
            "form_type": "XX",
            "form_name": "Non-clinical Patient Facing Occupational Health"
        }
    ]
}
Modified at 2024-08-09 12:14:13
Previous
Get Candidate Training Report - Unassigned
Next
Get Form Fields
Built with