Confirm Sms Trial Phone
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/sms/trial/phone/confirm" \ -H "Content-Type: application/json" \ -d '{ "code": "string" }'{ "configured": true, "available": true, "status": "none", "phone": "string", "pending_phone": "string", "code_expires_at": "2019-08-24T14:15:22Z", "texts_used": 0, "texts_limit": 0, "texts_left": 0}Check Verification
Check a verification form without filing anything (multipart/form-data). Takes the same parts as `POST /verifications` and runs every check Hail can run before filing: the purpose rules, the credit check (402), the carrier's form (a read), the duplicate check (409), field lengths, the files (`file.<slot>` and `upload.<slot>`: type, size, owner, age), and the form's own rules (required fields, documents, address; for `sms` the US texting application). Errors are the same codes and shapes submit gives. Nothing is filed at the carrier, saved, held or charged, and uploads are not used up. The carrier runs its own checks when you submit.
Confirm Verification
Enter the code the carrier texted to confirm a person's US texting registration. Use it when the verification shows `confirmation: "code"`. On success the campaign is usually filed at once. It waits when your credit does not cover its fee (`waiting_for_credit` is true until you add credit; `credit_needed_cents` says how much). It also waits while another check of it is running or recently failed, or another process holds it; a later check files it. Poll GET /verifications/{id} until `approved`. A wrong or expired code is 422 on `code`; after five wrong codes, 429 until the carrier sends a new code (once a day). 409 when there is nothing to confirm.