Search loading...


Explore and Make use of Nationally Defined Messaging APIs


API Monitoring

Guidance for monitoring the DoS APIs

Use a Case ID of ‘MONITORING’ when sending monitoring requests into the APIs

Some consumers need to monitor the state of the DoS APIs in order to ensure they can gracefully handle unavailability of the API to their application.

If you would need to do this, you must first get permission from the DoS team otherwise your account may be disabled.

  • Requests MUST be no more frequent than 1 every minute, but preferably 1 every 5 minutes

  • Search distance must be set to ‘1’

  • You MUST use a Case ID of ‘MONITORING’ in all requests.

e.g. in the path for the JSON / POC API:

e.g. in the payload for the SOAP API / Web Service:

  • For SOAP requests, you should not include the CaseRef element.

All content is available under the Open Government Licence v3.0, except where otherwise stated