Contact Verification

Check Verification

Check a verification code or PIN

Returns approved, pending (wrong code, with fewer attempts_remaining), expired or locked (after the 5th wrong attempt). Checking is free. Send code for email/SMS/WhatsApp verifications and pin for PIN checks.

Required Scopes: verifications:create

post/api/v1/verifications/{verification_id}/check

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/verifications/{verification_id}/check
  • Auth: HTTP bearer

Path parameters

verification_idstring required

Request body

codestring nullable

The 6-digit code (OTP methods)

pinstring nullable

The PIN (method 'pin')

Response

Successful Response

idstring required
statusstring required

approved, pending, expired or locked

attempts_remaininginteger required
contact_idstring nullable

Changes

No recorded changes to this operation across all 3 revisions of this API.