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

Get OTP by Recipient

Retrieve all OTP tokens for a specific recipient

Request

curl -X GET "https://api.simpu.co/otp/get-by-recipient"

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"
  }
]
GET

/otp/get-by-recipient

Request Parameters

QUERYParameters
recipient
stringrequired
Recipient of OTPs to retrieve

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 GET "https://api.simpu.co/otp/get-by-recipient"

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"
  }
]