Alerts - Alert files

This page provides technical details for the alert files that you receive from the service when one or more tracked events occurred for your subscribed numbers in a 24-hour period.

SFTP location

/home/ts_products/phone_id_monitor/customer_data/{your_suborg_id}/reports/

VariableDescription
your_suborg_idA number from Telesign identifying your organization.

Example

/home/ts_products/phoneid_monitor/customer_data/243203/reports/

File naming convention

REPORT_{timestamp}.csv

VariableDescription
timestampThe date and time when the file was created. The timestamp is in ISO-8601 format, with no milliseconds included, no special characters included, and "Z" included at the end. The period covered by the alert file is the 24 hours before this date and time

Example

REPORT_20190616140419.csv

Rows

Alert files contain a record for each tracked event that occurred over the covered 24-hour period.

Columns

The following table describes the fields used in the file.

Column Header and NameDescriptionExample
MSISDNThe subscribed end user’s phone number related to this event, in international format with country code.14089000001
COUNTRYCountry code (ISO2) of the subscribed phone number related to this event.US
MONITOR_DATEA timestamp indicating when the service started monitoring this phone number.2019-01-01T05:48:45.620Z
EVENT_TYPEThe type of event this record is for (DEACTIVATED, PORTED, or SWAPPED).DEACTIVATED
DEACTIVATION_DATETimestamp for the date that deactivation occurred for this phone number. There is only a value here if the event type is DEACTIVATED.2019-05-05
PORT_DATETimestamp for the date this phone number was ported. There is only a value here if the event type is PORTED.2019-01-01T05:48:45.620Z
CARRIER_NAMEThe old carrier, if the event type is PORTED. For all other event types, this value is the current carrier.ATT
PORTED_TO_CARRIER_NAMEThe new carrier, if the event type is PORTED. There is only a value here if the event type is PORTED.VZW
CHANGE_DATETimestamp for the date that the number changed. There is only a value here if the event type is SWAPPED.2019-05-05
CHANGE_TO_NUMBERThe new phone number (MSISDN). There is only a value here if the event type is SWAPPED.14089000103

Did this page help you?