The Pull Notification API allows you to retrieve notification messages generated for you by Telstra Wholesale. The following notification types are currently supported by the API:
- Order Notifications (NBN order updates)
- Ticket Notifications (NBN and Copper tickets)
By default, the API returns only unread notifications that have not previously been received by you (notifications can be received via either the Push Notification or Pull Notification API). If required, previously received notifications can be retrieved by using the query parameter include=all or include=read. Once a notification has been returned by the Pull Notification API, it is marked as read and can only be retrieved using include=all or include=read.
The notifications to be returned can be filtered by specifying a date range in the query parameters. Additional filters can also be applied for each specific notification type and are described in the API specification section. If a large number of notifications match the request query parameters, pagination will be applied to the response. This will return a maximum of 50 records and a field specifying the URL to retrieve the next set of records.
You can make up to 20 simultaneous connections. Please contact Telstra Wholesale Support if this parameter needs to be adjusted for your company.
Notifications remain available for retrieval via the Pull Notification API for the following time periods, regardless of read/unread status:
|Notification Type||Notification Availability Period|
Terms and Conditions
Use of the Telstra Pull Notification API is bound by these Terms and Conditions. By agreeing to the overall t.dev Terms and Conditions when you sign up an account, you agree to all API specific Terms and Conditions.