---

Check out the following resources for all your API needs:

1. Your ultimate guide to API success: https://d7networks.com/docs
2. Streamline your API testing process with Postman: https://documenter.getpostman.com/view/9076938/UzXM1Jcc
3. Get a hands-on look at the functionality of our API using OpenAPI Spec: https://www.apimatic.io/api-docs/d7api

---

Requirements:

1. Join the D7 Community and create your account today!
2. Ensure seamless service by keeping your D7 account credit at a sufficient level.

---

Create app and get auth Token

The d7 user dashboard includes a developer section where you can create applications. Each application has its own authentication token.
For creating your first application, click here.
Make sure you copy the authentication token generated during app creation
Also the token can be regenerated at any time by clicking here.

The token will look like this:

eyJhbGadfadfciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWsdsgQiOiJhdXRoLWJhY2adatlbmQ6YXBadsfwIiwic3ad

---

Balance & Credits

Check here to see how many test credits and main balance you have left on your D7Networks account

Response:

    {
    "balance": 99.9999999
    }

---

Messages

1. Send Message

_ Request parameters

-	Parameters	Value / Pattern	Example(s)
	originator*	The Sender/Header of a message. We can use your brand name with a maximum character limit of 11 or your mobile number with your country code. If you would like to register a new Sender ID, you can submit your details here	SMSInfo
	recipients*	Mobile Numbers to send SMS seperated by comma in an array. The recipient’s phone number should have a country code prefix. You can also set the Default Country here, and all your messages will be prefixed with the selected country code.	+971509752555
	content*	The message content is being sent. A long message over 160 characters will be split into multiple messages with 153 characters each and forwarded to telecom. When Unicode messages exceed 70 characters, they are split into multiple messages of 63 characters each. Also, billing will be based on the number of message parts sent	Greetings from D7 API
	data_coding	Set as text for normal GSM 03.38 characters(English, normal characters). Set as unicode for non GSM 03.38 characters (Arabic, Chinese, Hebrew, Greek like regional languages and Unicode characters). Set as auto so we will find the data_coding based on your content.	text

* indicates Mandatory Parameter

_ Sample request body

{
   "messages": [
       {
           "channel": "sms",
           "originator": "D7-RapidAPI",
           "recipients": [
               "+9715097526xx",
               "+9715097526xx"
           ],
           "content": "Greetings from D7 API ",
           "data_coding": "text"
       }
   ]
}

_ Success Response

{
    "request_id": "e06b8ccb-eb07-4786-b188-25ebabcdc17",
    "status": "accepted",
    "created_at": "2023-02-01T08:46:26.390251"
}

---

Verify (OTP / 2FA)

1. Generate OTP

_ Request parameters

When calling D7Verify API from an application, the below parameters must be passed (at least mandatory ones) and the api will return the request id id on success.

-	Parameter	Value / Pattern	Example(s)
	*originator	The Sender/Header of a message. We can use your brand name with a maximum character limit of 11 or your mobile number with your country code. If you would like to register a new Sender ID, you can submit your details here	SMSInfo
	*recipients	Mobile Numbers to send OTP code.	+971509752555
	*content	OTP Message Content with {} placeholder	Greetings from D7 API, your mobile verification code is: {}
	*expiry	OTP Expiry time in seconds	600
	*data_coding	Set as text for normal GSM 03.38 characters(English, normal characters). Set as unicode for non GSM 03.38 characters (Arabic, Chinese, Hebrew, Greek like regional languages and Unicode characters). Set as auto so we will find the data_coding based on your content.	text

* indicates Mandatory Parameter

_ Sample request body

{
   "originator": "SignOTP",
   "recipient": "+971509752555",
   "content": "Greetings from D7 API, your mobile verification code is: {}",
   "expiry": "600",
   "data_coding": "text"
}

_ Response

When the request is validated, otp_id, status and expiry will be returned. Users can use this otp_id to regenerate otp and verify otp

_ Success

{
    "otp_id": "dfd31c0e-2cd2-494e-88d2-6cac05263a7f",
    "status": "OPEN",
    "expiry": 600
} 

2. Resend / Regenerate OTP

OTP can be regenerated using the otp_id which was returned from Generate OTP.

_ Sample request body

{
   "otp_id":"8d963dbf-d655-4fe6-9157-48885a036050"
}

_ Response

When the request is validated, otp_id, status and expiry will be returned. Users can use this otp_id to regenerate otp and verify otp

_ Success

{
    "otp_id": "84864e9c-81f5-41af-9483-c90dffd97e4a",
    "status": "OPEN",
    "expiry": 600,
    "resend_count": 1
} 

3. Verify OTP

Once the user recieve the OTP, it can be verified at this endpoint

_Sample request body

{
   "otp_id":"8d963dbf-d655-4fe6-9157-48885a036050",
   "otp_code":435986
}

_Response

When the request is validated the status will be returned.

_Success

{
    "status": "APPROVED"
}

4. Get OTP Status

You can always check the OTP status at this endpoint
** replace “OTPID” with one you got at the previous step

_Success Response

{
    "status": "OPEN"
}

---

*** For FREE SMS credits Signup here
*** Click here for detailed documentation.

D7 Verify

This document is targeted at software designers/programmers wishing to integrate D7 Verify for verification of phone numbers from the applications.

To start with D7 Verify, the following requirements must be met:

• Direct7 account and 2FA Token
• Sufficient credit on your Direct7 account

Features

• Customized message content

• Can specify a timeout for each verification

• Unlimited retry / resend option

Authentication

---

D7 Verify service use 2FA API token to authenticate users and you can easily get it from your verification-api on d7networks.com. The Authorization field must start with “Token” followed by the 2FA API token

Example::

Token 095asdfs15df54sad5fasdfad4f51asdfsdf9asd1fas1df

Send OTP

---

Parameters :

Parameter	Description	Mandatory	Example
mobile	Destination number which needs to be verified	YES	971562316353
sender_id	Source address, Default value is "RVSMS	YES	RVSMS
message	OTP Message content, always include {code} placeholder in message text.	NO	D7SMS OTP verification code is {code}
expiry	OTP Expiry time	NO	900

Result Format:

{
    "otp_id":"49dd75a1-3753-4f78-8cae-0ac52aa669ac"
    "status":"open"
    "expiry":900
}

If successful, response header HTTP status code will be 201 and the Response Body will contain otp_id,status and timeout.

Re-Send OTP

---

Parameters :

Parameter	Description	Mandatory	Example
otp_id	OTP id which was recieved when otp is generated	YES	49dd75a1-3753-4f78-8cae-0ac52aa669ac

Result Format:

{
    "otp_id":"49dd75a1-3753-4f78-8cae-0ac52aa669ac"
    "status":"open"
    "expiry":900
    "resend_count":1
}

If successful, response header HTTP status code will be 201 and and the Response Body will contain otp_id,status,expiry,resend_count.

Verify OTP

---

Parameters :

Parameter	Description	Mandatory	Example
otp_id	OTP id which was recieved when otp is generated	YES	eeefab33-ba6b-41b5-88b8-258ef56f2fc4
otp_code	OTP code received on Mobile number	YES	eeefab33-ba6b-41b5-88b8-258ef56f2fc4

Result Format:

{
    "status":"success"
}

For successful validation 200 OK response with status: success will be returned.
For a failure 200 OK with status: failed will be returned.

Support

---

For all the support requests and general queries you can contact support@d7networks.com
or visit contact-us
Also, you can avail the live chat available our website d7networks.com or you can text with
us via WhatsApp at +971566816452