Delete Agent
curl -X DELETE "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"Create Verification
Submit your details and documents (multipart/form-data). Parts: `purpose` (`number`, the default, or `sms` to register to send SMS in the US; use US/local for 10DLC, or US/CA and toll_free with number_id for free per-number toll-free verification; 10DLC fees are charged from credit per step, when the details are submitted and when the carriers start their review, and 402 means there is not enough credit to file, also when a kept brand cannot be reused and the credit does not cover a new one), `country_code`, `number_type`, `subject_type` (required: `person` for you, `business` for your company; ask the user which), `quote_id` (required for `number`: the offer to verify for), `number_id` (optional, for `sms`: one of your US numbers; needed when your US numbers are with more than one carrier), `fields` (JSON object), `address` (JSON object, when required), `documents` (JSON object: slot name to `{"option": ..., "fields": {...}}`), and for each slot either a file part named `file.<slot>` or a text part named `upload.<slot>` holding the id of a `verification_document` uploaded with `POST /uploads` less than 1 hour ago (not both). Files are JPG, PNG or PDF, 10 MB each at most. Get the slot and field names from `GET /verifications/requirements`. Used uploads are deleted once the verification is saved; after a failed submit they stay for a retry. The name of the person or company comes from the form you send (for example the business name, or the first and last name) and is shown back as `subject_name`. For a number you may hold several verifications of each subject type (several people, several companies); a second live one of the same subject type and the same name is a 409, and so is a second live one of the same subject type when the form holds no name. A 409 comes before your files are checked and before anything is filed. A number verification needs credit for the offer's setup and first month (`setup_cents` + `monthly_cents` of the quote); without it, 402 and nothing is filed. That amount is set aside from your balance while the carrier checks your papers. It pays for setup and the first month when you buy the number with this verification, and comes back if the verification is rejected or cancelled, or if no number is bought with it within 30 days of approval. A by-request offer sets nothing aside. The carrier checks the details right away. Problems come back as 422 with the field named, and nothing is kept. When it passes, the verification is submitted to the carrier for its review; read it back to follow the state. For a number registration Hail keeps your answers (fields, address, document options) and an encrypted copy of each file for 30 days after submit, so a rejected filing can be fixed and sent again (`POST /v1/verifications/{id}/resubmit`). They are deleted sooner when the registration is approved or cancelled, or the account closes. A `provider` part is deprecated and ignored: Hail picks the carrier.
Delete Contact
Permanently remove a manual contact. Manual contacts only — a member: id returns 422; org members are removed via the membership APIs, not this route. Irreversible.