Checking Monitored Phone Numbers

Introduction

PNV Customers can use the PNV Premium monitoring feature to receive automatic notifications for phone number events.

To use the feature the PNV customers subscribes lists of phone numbers using the Batch Scrub & Monitor feature.

The customer can also unsubscribe numbers using the batch unsubscribe feature. Disconnected phone numbers are also automatically unsubscribed.

More details on all the above are available here and here.

Due to the ongoing changes, the PNV customer may want to verify which phone numbers are subscribed.

The Subscriptions dump feature enables the customer to do this.

The feature is an API call, which triggers the generation of a file containing a list of all the subscribed phone numbers.

Due to the file size, the list is not returned in the API call, but is created as a file and stored on the Media Storage Service. This is the same service used for batch file storage.

Dump Subscriptions API Call

A single GET API Call is used to trigger the create of the subscription list.

Request

URL

GET https://api.syniverse.com/ess/v1/topics/NIS-Events/dump-subscriptions?compression=true&compressionType=zip

Headers

Content-Type: application/json

Authorization: Bearer {Your Bearer Token}

 

Response

The API response will contain the reference id for the file which will be created.
i.e. {"file-reference-id":"123456789"}

Downloading the Subscriptions List File

When to download the file

Depending on the number of the subscriptions, the file can take some time to create.

If desired the customer can be notified via a webhook once the file creation is complete.

Alternatively the customer may choose to wait for an period of time before attempting the download.

If the customer prefers to use a notification, then they need to create a delivery configuration & subscription first. More details on how to set up Event Manager are available here

Downloading Output file

The output file is downloaded using a single API call to the MSS service. This API call uses the file reference id in the previous response

Request

URL

GET http://api.syniverse.com:8080/mediastorage/v1/files/<<file-reference-id>>/content

Headers

Content-Type: application/json

Authorization: Bearer {Your Bearer Token}

int-companyId: {your company-id}

 

Response and Output File Format

The response will include the output file.

The output file contains a list of the subscriptions, for each subscription it will include

  • delivery configuration
  • topic and event subscribed to
  • number subscribed
  • start and end dates for the subscription

An example is provided below

{"del-cfg-id":"123", "topic-nm":"NIS-Events", "evt-tp":"porting_event", "match-crt":"number=+1234567890", "start-date":"11-OCT-16", "end-date":"10-OCT-17"}

{"del-cfg-id":"123", "topic-nm":"NIS-Events", "evt-tp":"porting_event", "match-crt":"number=+4567890123", "start-date":"01-JAN-17", "end-date":"12-DEC-17"}

Was this article helpful?
0 out of 0 found this helpful

0 Comments

Please sign in to leave a comment.