Check a code
A matching code approves the verification and is used up. Five wrong codes fail it. A code past its ttl is refused with verification_expired.
Authorization
bearerAuth verifications:writeAuthorization: Bearer sk_live_.... Keys in the query string or the
request body are refused — a URL is logged by every proxy it passes,
and that is how customer keys leak.
A key carries scopes. A call outside them answers 403 with
insufficient_scope and names the scope it wanted.
In: header
Scope: verifications:write
Path Parameters
The prefixed id of the object.
Header Parameters
Any unique string, one per logical request. Retrying with the same key
returns the first answer instead of doing the work twice, and answers
with Idempotent-Replay: true. Server errors (5xx) and
rate_limit_exceeded (429) are not remembered, because neither did
any work; every other answer is, refusals included.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST https://app.sendkuy.com/api/v1/verifications/vrf_9cBe3A1H-SLhW5fONWZ32wb-IIio5Ts3/check \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "code": "123456"}'{ "data": { "object": "verification", "id": "vrf_7hTq2L9x-KcVw4mZ0rBnYs1-dE5pAa8", "to": "string", "email": "string", "channels": [ "whatsapp" ], "channel": "string", "status": "pending", "attempts": [ { "channel": "whatsapp", "message_id": "string", "outcome": "sent", "reason": "string", "created_at": "2019-08-24T14:15:22Z" } ], "checks_remaining": 0, "expires_at": "2019-08-24T14:15:22Z", "approved_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z" }}