Get Started

    API Endpoint

        http://api.mrnotify.lk/
                

The MrNotify APIs provides programmatic access to MrNotify Portal

To use MrNotify APIs, you need an API key. Get the required credentials from your Merchant Account

Subscription API


# Here is a curl example
curl -X POST \
  http://api.mrnotify.lk/subscription \
  -H 'content-type: multipart/form-data; boundary=***someboundary***' \
  -F 'account="YOUR-ACCOUNT"' \
  -F 'apikey="YOUR-API-KEY"' \
  -F 'msisdn="MOBILE-NUMBER"'
                

To subscribe you need to make a POST call to the following url :
http://api.mrnotify.lk/subscription



Result example :

{
    "account": "MrNotify",
    "msisdn": "+94767337033",
    "statusCode": "S1000",
    "statusDetail": "SUBSCRIBED"
}
                

QUERY PARAMETERS

Field Type Description
account String YOUR-ACCOUNT
apikey String YOUR-API-KEY
msisdn String Mobile Number [Sri Lankan]

Unsubscription API


# Here is a curl example
curl -X POST \
  http://api.mrnotify.lk/unsubscription \
  -H 'content-type: multipart/form-data; boundary=***someboundary***' \
  -F 'account="YOUR-ACCOUNT"' \
  -F 'apikey="YOUR-API-KEY"' \
  -F 'msisdn="MOBILE-NUMBER"'
                

To unsubscribe you need to make a POST call to the following url :
http://api.mrnotify.lk/unsubscription



Result example :

{
    "account": "MrNotify",
    "msisdn": "+94767337033",
    "statusCode": "S1000",
    "statusDetail": "UNSUBSCRIBED"
}
                

QUERY PARAMETERS

Field Type Description
account String YOUR-ACCOUNT
apikey String YOUR-API-KEY
msisdn String Mobile Number [Sri Lankan]

SMS API


# Here is a curl example
curl -X POST \
  http://api.mrnotify.lk/sms \
  -H 'content-type: multipart/form-data; boundary=***someboundary***' \
  -F 'account="YOUR-ACCOUNT"' \
  -F 'apikey="YOUR-API-KEY"' \
  -F 'msisdn="MOBILE-NUMBER"' \
  -F 'message="MESSAGE-BODY"'
                

To send a SMS you need to make a POST call to the following url :
http://api.mrnotify.lk/sms



Result example :

{
    "account": "MrNotify",
    "msisdn": "+94767337033",
    "message": "HelloWorld",
    "statusCode": "S1000",
    "statusDetail": "Success"
}
                

QUERY PARAMETERS

Field Type Description
account String YOUR-ACCOUNT
apikey String YOUR-API-KEY
msisdn String Mobile Number [Sri Lankan]
message String Message Body

Broadcast API


# Here is a curl example
curl -X POST \
  http://api.mrnotify.lk/broadcast \
  -H 'content-type: multipart/form-data; boundary=***someboundary***' \
  -F 'account="YOUR-ACCOUNT"' \
  -F 'apikey="YOUR-API-KEY"' \
  -F 'msisdn="MOBILE-NUMBER"' \
  -F 'message="MESSAGE-BODY"'
                

To directly subscribe msisdn and send SMS you need to make a POST call to the following url :
http://api.mrnotify.lk/broadcast



Result example :

{
    "account": "MrNotify",
    "msisdn": "+94767337033",
    "message": "HelloWorld",
    "statusCode": "S1000",
    "statusDetail": "Success"
}
                

QUERY PARAMETERS

Field Type Description
account String YOUR-ACCOUNT
apikey String YOUR-API-KEY
msisdn String Mobile Number [Sri Lankan]
message String Message Body

Balance API


# Here is a curl example
curl -X POST \
  http://api.mrnotify.lk/balance \
  -H 'content-type: multipart/form-data; boundary=***someboundary***' \
  -F 'account="YOUR-ACCOUNT"' \
  -F 'apikey="YOUR-API-KEY"'
                

To query your account balance you need to make a POST call to the following url :
http://api.mrnotify.lk/balance



Result example :

{
    "account": "MrNotify",
    "balanceCredits": "275",
    "creditsValidity": "2017-07-31",
    "accountStatus": "1"
}
                

QUERY PARAMETERS

Field Type Description
account String YOUR-ACCOUNT
apikey String YOUR-API-KEY

Error Codes

The MrNotify API uses the following error codes:

Error Code Meaning
E1234 MSISDN Blacklisted the Application via Customer Care
E5678 MSISDN Blacklisted the Application via SMS
E6000 Character Count > 452
E7000 System Error. Contact Support Team
E8000 Please Recharge your Account
E9000 Authentication Failed

Questions or Problems ?

If you run into any difficulties or can’t get something to work. Don’t hesitate to contact us via devsupport@mrnotify.lk. We would love to help you out.