API-x JSON Data on Success

  31 January 2017

When call to API-x is successful, the response returned is 1000 followed by a pair of vertical lines and a json data.

JSON Data format

{
 "successful": "",
 "basic_successful": "",
 "corp_successful": "",
 "failed": "",
 "insufficient_unit": "",
 "invalid": "",
 "all_numbers": "",
 "units_used": ,
 "basic_units": ,
 "corp_units": ,
 "units_before": "",
 "units_after": "",
 "sms_pages": ,
 "filtered_active": "",
 "filtered_dead": "",
 "filtered_nodata": "",
 "filtered_dnd": "",
 "realtime_dnd": "",
 "message_id": ""
}

 

Explanation of the JSON Data

Parameter

Type

Description

successful

String

This lists the phone numbers that the message has been sent successfully separated by commas (,). These constitute the billable phone numbers.

basic_successful

String

This lists the phone numbers that were successfully sent via the Basic Route.

corp_successful

String

This lists the phone numbers that were successfully sent via the Corporate Route.

failed

String

This lists the phone numbers that the message could not be delivered. Phone numbers in this list are NOT billed. Possible causes are:

a. Unsupported gateway

b. Message rejected by the operator

c. Phone numbers could not be parsed

insufficient_unit

String

Phone numbers that failed because there was no sufficient SMS credit to send messages to them.

invalid

String

Invalid phone numbers that were removed from the recipients’ parameter string. These are not billed.

all_numbers

String

All the valid phone numbers supplied from the recipients string.

units_used

Float

The sum of SMS units used

basic_units

Float

The sum of SMS units used to send messages via the Basic Route

corp_units

Float

The sum of SMS units used to send messages via the Corporate Route

units_before

Float

The account balance before the message was sent

units_after

Float

The account balance after the message has been sent

sms_pages

Integer

The number of pages of the SMS

filtered_active

String

This will be populated when set routing=2. This shows phone numbers that were filtered as active during the phone number validity test.

filtered_dead

String

The will be populated when set routing=2. This shows phone numbers that are currently dead/inactive based on the available data used for the validity test.

filtered_nodata

String

The will be populated when set routing=2. This shows phone numbers that we do not have any data on as at the time of query.

filtered_dnd

String

The will be populated when set routing=2. This shows phone numbers that are on DND based on available data.

realtime_dnd

String

This shows phone numbers that the operator signals as being on DND. This provides more accurate DND status for the phone number.

message_id

String

The unique server generated identifier for the message.

 

 

REGISTER FREE

  • 10 Free SMS on Sign-Up
  • 5% Bonus on First Purchase
  • Delivery Report Available
  • Most Affordable Pricing
  • Easy Payment Channels

Popular Posts

Headlines

Latest Comment

  • Gire Benjamin Gire Benjamin
    Good Afternoon, Welcome to SmartSMSsolutions Please how may i assist you ?

    Read more...

     
  • Gire Benjamin Gire Benjamin
    Good Afternoon, Thank you for contacting us, We sincerely apologize for the inconveniences, Please kindly ...

    Read more...

     
  • nweguikechukwuogbonna56 nweguikechukwuogbonna56
    Hw are u

    Read more...

     
  • agboolaesthert agboolaesthert
    #God'sLove Good evening. Pls I do not understand these words I got after sending SMS One heading with ...

    Read more...

     
  • Gire Benjamin Gire Benjamin
    Good Afternoon Olaoluwa, Thank you for contacting us , Please be informed that the application is ...

    Read more...

Blog Calendar

« April 2020 »
Mon Tue Wed Thu Fri Sat Sun
    1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30