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 6-digit code submitted by the user

Response

200 OK — Valid
{
  "valid": true,
  "message_id": "msg_abc123",
  "channel": "sms",
  "verified_at": "2026-03-18T12:00:00Z"
}
200 OK — Invalid
{
  "valid": false,
  "message_id": "msg_abc123",
  "reason": "invalid_code"
}