Send basic message

Send basic message

post

This API is granted only to customers with verified companies after a review compared to the templated API which is granted by default.

Callback request example (DLR - delivery notification)

POST /<callback_url>

{
  "error": "000",
  "from": "18888112345",
  "message_id": "8bd71f49-6f42-4729-bf5e-ecf857747633",
  "status": "DELIVERED",
  "to": "16197012345",
  "type": "DLR"
}

Each request contains the following information:

• message_id - the id of the message which has been returned following /send request

• from - the source address the message was sent from

• to - the destination address which has received the message

• status- the status of the message

  • DELIVERED - Message has been delivered

  • EXPIRED - Message wasn't delivered within the 48 hour period

  • UNDELIVERABLE - Message wasn't delivered (check the error)

  • UNKNOWN - Message wasn't delivered due to a unknown reason

  • REJECTED - Message was rejected by the supplier (check the error)

• type- type of the callback, either DLR for delivery notification or MO for mobile originated message

• error - The error code returned by the supplier (check the table below for possible values)

EC	ERROR DESCRIPTION
0	DELIVERED
1	UNKNOWN_SUBSCRIBER
5	UNIDENTIFIED_SUBSCRIBER
9	ILLEGAL_SUBSCRIBER
11	TELESERVICE_NOT_PROVISIONED
13	CALL_BARRED
21	FACILITY_NOT_SUPPORTED
27	ABSENT_SUBSCRIBER
31	SUBSCRIBER_BUSY_FOR_MT_SMS
32	DELIVERY_FAILURE
34	SYSTEM_FAILURE
36	UNEXPECTED_DATA_VALUE
37	MEMORY_CAPACITY_EXCEEDED
38	PREFIX_NOT_RESOLVED
39	IMSI_BLACKLISTED
40	DEST_ADDRESS_BLACKLISTED
41	TIME_OUT
43	INVALID_ORIGINATOR_ADDRESS
100	GENERAL_ERROR
200	EQUIPMENT_PROTOCOL_ERROR
201	UNKNOWN_MSC
202	CONGESTION_ERROR
203	PARAMETER_MISSMATCH
204	INITIATING_RELEASE
205	POTENTIAL_VERSION_INCOMPATIBILITY
206	REMOTE_NODE_NOT_REACHABLE
207	MTP_FAILURE
346	CLIENT_NETWORK_FORBIDDEN (In a case of MNP being performed)
351	INVALID_PREFIX_OR_DESTINATION
4100	EXPIRED_ON_FORCE_RETRY (When the time to live has been configured for delivery and it has expired)

Callback request example (MO - mobile originated message)

POST /<callback_url>

{
  "from": "16197012345",
  "message_id": "2d7114a6-bd45-4022-98ab-15d36cc2b9bd",
  "text": "STOP",
  "to": "18888112345",
  "type": "MO"
}

Each request contains the following information:

• message_id - the id of the mobile originated message

• from - the mobile number the message has been sent from

• to - the mobile number which has received the message

• type- type of the callback, either DLR for delivery notification or MO for mobile originated message

• text - the text of the message which has been sent from to to number

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

API key header.

Body

application/json

fromstringRequired

Defines which sender name is going to be visible to the customer once the message has been received on the mobile handset

Default: YourCompany

tostringRequired

Defines a number to which the message is being set

Default: 447916123456

textstringRequired

The message text which is being sent to the mobile handset

Default: Your one time pin code is 123456

callback_urlstringOptional

Optional URL to which updates related to message delivery will be received

Default: ""

Responses

200

200

application/json

or

400

400

application/json

401

401

application/json

429

429

application/json

500

500

application/json

post/v1.0/send

HTTPcURLJavaScriptPython

POST /v1.0/send HTTP/1.1
Host: messaging-api.bind.hr
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "from": "YourCompany",
  "to": "447916123456",
  "text": "Your one time pin code is 123456",
  "callback_url": "https://example.com/callback"
}

{
  "status": "ACCEPTED",
  "message_id": "d2932311-5c1b-48cc-93cf-33e2f8d4f95d",
  "error_message": "OK",
  "cost": 0.075,
  "count": 1
}