Home
Home
  1. Availability Check
  • Welcome
    • About Ontime
    • Overview
    • Test and Learn Projects
  • Authentication
  • Availability Check
    • Light Availability Check
      POST
    • Full Availability Check
      POST
  • Payment Management
    • Mandates
      • Create a new mandate
      • Cancel an existing mandate
      • Get a Mandate
      • Get many Mandates
    • Payment Requests
      • Instruct a new payment request
      • Cancel an existing payment request
      • Get a Payment
      • Get many Payments
  • Payouts
    • Get a Payout
      GET
    • Get Available Payouts
      GET
  • Webhooks
    • Mandate Created/Updated
    • Payment Request Created/Updated
    • Payout Created
  1. Availability Check

Full Availability Check

Developing
Cloud Mock
https://mock.apidog.com/m1/828215-0-default
Cloud Mock
https://mock.apidog.com/m1/828215-0-default
POST
https://mock.apidog.com/m1/828215-0-default
/availability/
OperationId:availability_check
Returns a definitive availability status (Confirmed/Unavailable), along with any available employment data we can provide for the consumer. Requires National Registration Number for the consumer.
Ensure you have captured the requsite consent from the consumer before calling this API.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: https://{domain}.auth.{region}.amazoncognito.com
Scopes:
availability:check-Determine if the consumer is available to pay by Ontime.
or
Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mock.apidog.com/m1/828215-0-default/availability/' \
--header 'x-api-key: <api-key>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "availability_check": {
        "national_registration_number": "QQ999999A",
        "date_of_birth": "1962-07-04",
        "given_name": "Ida",
        "family_name": "Jerde",
        "email_address": "Marianna_Tillman67@example.org",
        "phone_number": "+13343564975",
        "postal_code": "GU12AA",
        "currency": "GTQ"
    }
}'
Response Response Example
{
    "availability_check": {
        "national_registration_number": "37",
        "availability_status": "Available",
        "tenure": 288,
        "industry": "labore laborum et amet commodo",
        "contract_type": "PartTime",
        "annualised_pay": 432100,
        "recommended_due_date": 23,
        "request_id": "5a5e5205-9ea2-4d5d-9c99-c842a0811453",
        "currency": "XPF"
    }
}
Previous
Light Availability Check
Next
Payment Management