Logo

Getting Started

IntroductionAuthentication

OTP

POSTRequest OTPPOSTVerify OTPDELETERevoke OTPGETGet TokenGETGet OTP by Recipient

Texts

POSTSend SMSSMS Final Status CodesSMS Character Sets

Lookup

GETPhone Lookup

Mails

POSTSend Email

Airtime

POSTBuy Airtime

Lists

GETGet contact listGETGet rowPOSTCreate rowPATCHUpdate rowDELETEDelete row
Logo
DocumentationAPI ReferenceChangelog

OTP

Verify OTP

Verify an OTP token with the provided code

Request

curl -X POST "https://api.simpu.co/otp/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "123456",
    "id": "674535b2b39158b9aae90188fcec23eb"
  }'

Response

{
  "id": "674535b2b39158b9aae90188fcec23eb",
  "recipient": "2348023456789",
  "status": 1,
  "status_desc": "SENT",
  "created_datetime": "2024-06-28T23:56:38.128604+00:00",
  "updated_datetime": "2024-06-28T23:56:38.128604+00:00"
}
POST

/otp/verify

Request Body

application/json

OTP verify request object

token
stringrequired
The OTP token to verify
Example: "123456"
id
stringrequired
The ID of the OTP token to verify
Example: "674535b2b39158b9aae90188fcec23eb"

Response

application/json

OTP response

id
stringrequired
ID of the OTP token
Example: "674535b2b39158b9aae90188fcec23eb"
recipient
stringrequired
Recipient of the OTP token
Example: "2348023456789"
status
numberrequired
Status of the OTP token
Example: 1
status_desc
stringrequired
Description of the status of the OTP token
Example: "SENT"
created_datetime
stringrequired
Date and time the OTP token was created
Example: "2024-06-28T23:56:38.128604+00:00"
updated_datetime
string
Date and time the OTP token was last updated, if any
Example: "2024-06-28T23:56:38.128604+00:00"

Built with Chakra UI

Request

curl -X POST "https://api.simpu.co/otp/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "123456",
    "id": "674535b2b39158b9aae90188fcec23eb"
  }'

Response

{
  "id": "674535b2b39158b9aae90188fcec23eb",
  "recipient": "2348023456789",
  "status": 1,
  "status_desc": "SENT",
  "created_datetime": "2024-06-28T23:56:38.128604+00:00",
  "updated_datetime": "2024-06-28T23:56:38.128604+00:00"
}