API-x JSON Data on Failure

  31 January 2017

When you make an unsuccessful call to the API-x, an error response is returned. This can be in any of the following formats.

Authentication Error

When there is an authentication error the response is in the format below:

1001||{JSON_DATA}

JSON Data Format

{
 "error": "true",
 "comment": "Reason for the error",
}

sn

Parameter

Type

Description

1

"error"

Boolean

This will be set to TRUE.

2

"comment"

String

Description of the error. Possible causes are: Invalid token, expired token and Error validating token

Error Sending SMS

When there is an error sending SMS the reply will be in the format below:

1002||{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": ""
}

The json data will be exactly as when a message is sent successfully to provide detailed insight to the reason for the failure. Possible reasons are application error, gateway error or parameter error. Our support centre will be very glad to provide the needed assistance should you encounter error sending SMS. You can please mail This email address is being protected from spambots. You need JavaScript enabled to view it. to get one of developers to attend to you.

Insufficient Balance

When there is an insufficient balance error, the response is in the format below:

1003||{JSON_DATA}

JSON Data Format

{
 "available": "30",
 "needed": "62",
}

sn

Parameter

Type

Description

1

"available"

Float

Currently available SMS balance

2

"needed"

Float

The required SMS credit to deliver the message.

No Valid Phone Number Found

When there is no valid phone number found, the recipient string the response is in the format below:

1004||{JSON_DATA}

JSON Data Format

{
 "invalid": "23470342333261,234803551586"
}

 

sn

Parameter

Type

Description

1

"invalid"

String

List of the invalid phone numbers found.

Application Error

When there is a general application error the response is in the format below:

1005||{JSON_DATA}

JSON Data Format

{
 "error": "true",
 "comment": "Reason for the error",
}

sn

Parameter

Type

Description

1

"error"

Boolean

This will be set to TRUE.

2

"comment"

String

Description of the error.

 

Unregistered Sender ID

Certain categories of messages require that the Sender IDs are pre-registered. If the Sender ID supplied is not part of the pre-registered group, the message will fail with the following error:

1008||{JSON_DATA}

JSON Data Format

{
 "error": "true",
 "comment": "Reason for the error",
}

sn

Parameter

Type

Description

1

"error"

Boolean

This will be set to TRUE.

2

"comment"

String

Description of the error.

 

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 Evening Sir , I am very sorry for that experience Sir.. The Notification on the Site tells Us ...

    Read more...

     
  • EZECHUKWU HENRY UGONNA EZECHUKWU HENRY UGONNA
    Most of my dnd numbers did not got my sms even when using option2. Some messages was sent but was not ...

    Read more...

     
  • Olorunlami Jephthah Olorunlami Jephthah
    Good day The Fig, thank you so much for reaching us here. As discussed with you over the phone, this ...

    Read more...

     
  • The fig montenssori school The fig montenssori school
    Please, why the sender name change on delivery to another name?

    Read more...

     
  • Gire Benjamin Gire Benjamin
    Good Evening Dayo, We sincerely apologize for the inconvenience you must have passed through . please ...

    Read more...

Blog Calendar

« February 2019 »
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