6th November 2019
HMRC are planning an update to the Pull Notification API in Trade Test. The implementation is currently planned for the morning of the 7th November Thursday by 8.30am
This will not require any downtime to the service.
The updated version of the API Approach document, previously shared in March, includes the 3 planned additional endpoints to the Pull Notification API.
A summary of the planned changes has been included below and will be released on the Dev Hub once the implementation is complete.
You can now get notification identifiers for a given conversation identifier by using one of these three endpoints:
These endpoints will help developers manage the retrieval of notifications on a more granular basis.Up until now, you have been able to get all pulled or unpulled notifications for your registered application.
Now you can check the notifications for a specific conversation identifier, then choose to get some or all of these notifications. This should help with diagnosing any issues you may have with retrieval of notifications.
The existing Pull Notifications API endpoints remain available and unchanged.
We have deprecated these 2 endpoints:
These endpoints will function as normal until they are removed in a future release. These endpoints are being deprecated because we found developers were deleting notifications, then needing to get them again. For this reason, we moved to have the unpulled and pulled notification queues.
HMRC do not recommend using these two endpoints.
Recommended usage pattern
You can get all of the notifications for your application or you can get them for a given conversation identifier. We recommend getting them by conversation, as follows: