Using this API product
Description
You can use the DSG health check API to check the current operational status of the ATO Digital Services Gateway to determine its readiness to accept traffic.
API Risk Rating
1 - No risk
For more information, see API risk rating.
Authentication
See: M2M client authentication.
Authorisation
For authorisation test scenarios, see: Authorisation test scenarios.
Scopes
ato.healthcheck.*.*
Rate Limit
Appropriate rate limits are applied to prevent misuse or overuse of the API.
API List
Health Check API
You can use this API to test you are able to successfully connect to the DSG.
This API has the following endpoints:
- GET {serverUrl}/healthcheck/v1/heartbeat Use this endpoint to make a request to check your connection to the DSG
- GET {serverUrl}/healthcheck/v1/clients/ABN/{abn_business}/individuals/TFN/{tfn_individual}/heartbeat Use this endpoint to make an authorized request to check your connection to the DSG using the payer ABN in sandbox environment
- GET {serverUrl}/healthcheck/v1/clients/WPN/{wpn_business}/individuals/TFN/{tfn_individual}/heartbeat Use this endpoint to make an authorized request to check your connection to the DSG using the payer WPN in sandbox environment
- GET {serverUrl}/healthcheck/v1/ Use this endpoint to give the current version and status of the healthcheck API
- GET {serverUrl}/healthcheck/v1/specs/yaml Use this endpoint to view the Healthcheck Open API specification in YAML format
- GET {serverUrl}/healthcheck/v1/specs/spec.yaml Use this endpoint to download the Healthcheck Open API specification in YAML format
Note: {serverUrl}/healthcheck/v1/heartbeat endpoint will check your connection to the DSG via authentication but not authorization. The following endpoints {serverUrl}/healthcheck/v1/clients/ABN/{abn_business}/individuals/TFN/{tfn_individual}/heartbeat and {serverUrl}/healthcheck/v1/clients/WPN/{wpn_business}/individuals/TFN/{tfn_individual}/heartbeat will check your connection to the DSG via authentication and authorization.
For more in-depth information refer to the endpoint paths in the specifications below around the use of the endpoints and desired input path and query parameters.
API specification
Release notes
Republishing the API Product Page.
Last Modified 18/09/2023