POST

/v1/check

Verify a one-time password code.

Endpoint

POST https://api.yoursend.dev/v1/check

Request Body

FieldTypeRequiredDescription
message_idstringYesThe message_id from the send response
codestringYesThe code submitted by the user (must be exactly 6 characters)

This endpoint is rate-limited to 30 attempts per 10 minutes.

Response

200 OK — Verified
{
  "message_id": "8f14e45f-ceea-467a-9b3a-1d2c3e4f5a6b",
  "status": "verified",
  "verified": true
}
200 OK — Wrong code
{
  "message_id": "8f14e45f-ceea-467a-9b3a-1d2c3e4f5a6b",
  "status": "pending",
  "verified": false,
  "remaining_attempts": 4
}