Worked request and response samples

{
  "data": {
    "verification_id": "ver_3f6a81c2d4e5471a9b0c2d5e",
    "destination": "+14155552671",
    "channel": "sms",
    "expires_at": "2026-08-01T12:10:00.000Z"
  },
  "meta": {
    "request_id": "req_send",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

Copy a request body as written, substitute your own ids, and compare the response envelope. Errors follow Devotel Orbit’s { error, meta } envelope, shown once below under Error envelope.

Send a verification code

POST /api/v1/verify/send

Pick the channel you deliver the code on, and hold onto the returned verification_id for the check call. Request

{
  "destination": "+14155552671",
  "channel": "sms",
  "template_id": "tmpl_9e8d7c6b5a4f3021e5d6c7b8"
}

{
  "data": {
    "verification_id": "ver_3f6a81c2d4e5471a9b0c2d5e",
    "destination": "+14155552671",
    "channel": "sms",
    "expires_at": "2026-08-01T12:10:00.000Z"
  },
  "meta": {
    "request_id": "req_send",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

Check a code

POST /api/v1/verify/check

Send the verification_id from the send call and the code the user typed. Request

{
  "verification_id": "ver_3f6a81c2d4e5471a9b0c2d5e",
  "code": "123456"
}

{
  "data": {
    "verification_id": "ver_3f6a81c2d4e5471a9b0c2d5e",
    "status": "verified"
  },
  "meta": {
    "request_id": "req_check",
    "timestamp": "2026-08-01T12:00:30.000Z"
  }
}

Error envelope

An expired or wrong code returns 422 with VALIDATION_ERROR; repeated wrong codes are rate-limited.

422

{
  "error": {
    "code": "INVALID_CODE",
    "status": 422,
    "message": "verification code does not match"
  },
  "meta": {
    "request_id": "req_...",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

API Reference

All Endpoints

Worked request and response samples