Verify: check

POST/verify/{id}/check

POST /verify/{id}/check: compare the code the user typed. Free.

Compare the code the user typed. Always free, always 200 with the verification object; branch on status:

status	Meaning
approved	The code matched. Terminal; sign the user in. Later checks keep answering approved.
pending	Wrong code, attempts remain: show `attempts_left`.
failed	Fifth wrong code. Terminal; even the right code is refused now. Start a new verification.
expired	10 minutes passed since the last send. The code was not compared. Start a new verification.

Request

curl -X POST https://sendy.co.il/api/v1/verify/cmv8s1x2y0001abcd12345678/check \
  -H "Authorization: Bearer sk_live_8Jc…" \
  -H "Content-Type: application/json" \
  -d '{ "code": "482913" }'

const res = await fetch(`https://sendy.co.il/api/v1/verify/${verification.id}/check`, {
  method: "POST",
  headers: { Authorization: "Bearer sk_live_8Jc…", "Content-Type": "application/json" },
  body: JSON.stringify({ code: typedCode }),
});
const { status, attempts_left } = await res.json();

Response · 200 OK

{ "id": "cmv8s1x2y0001abcd12345678", "status": "approved", "verified_at": "2026-10-24T14:02:11.000Z", … }