Submit a verification
submit_verificationSubmit authorized applicant details and documents for carrier registration.
Submission is irreversible once sent for review. Carriers retain submitted documents.
``fields``, ``address``, ``documents`` and ``files`` follow the carrier's current requirements.
SMS campaign text requires user review and approval before submission.
``purpose="number"``: the balance must cover the offer's setup fee plus first month;
otherwise nothing is sent. That amount is reserved during review and pays for a
later purchase using this registration. It is returned after rejection, cancellation
or 30 days without purchase following approval.
``purpose="sms"`` registers US local numbers for US texting with carrier filing fees.
Free toll-free verification uses type ``toll_free``, country ``US`` or ``CA``, the
owned ``number_id`` and ``registration_kind=toll_free`` among the form fields.
Base64 files are written into the tool call and add about a third to their size.
Base64 files total at most 29 MiB, checked here; the API checks the 30 MB total of
all files, uploads included. Slot names use letters, digits, hyphens and underscores,
up to 64 characters. At most 100 fields are accepted.
``check_verification`` takes the same arguments and files nothing.
Returns ``id``, ``state`` and ``subject_name``. Carrier review takes business days.
A 409 identifies an existing registration; a timeout can leave a submission in progress.
Carrier field errors include ``problems`` and leave no saved submission.Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country_code": "<country_code>",
"number_type": "<number_type>",
"fields": "<fields>",
"documents": "<documents>",
"files": "<files>",
"attest_authorized": "<attest_authorized>"
},
"name": "submit_verification"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | The document files, one per slot named in ``documents``. Use an upload: the ``id`` from ``create_file_upload`` with purpose ``verification_document``, within an hour of uploading. A very small file can go inline as base64 instead. Each file is at most 10 MiB. | |
| fields | Yes | Applicant answers keyed by the field names in ``get_verification_requirements``. Choice fields take comma-separated option keys. | |
| address | No | The applicant's address. Give it when the requirements include one; otherwise leave it out. | |
| purpose | No | What the registration is for: ``number`` registers the applicant so a number can be bought; ``sms`` registers US texting (local 10DLC or toll-free). | number |
| quote_id | No | The number offer this registration lets the user buy: the offer's ``quote_id`` from ``quote_numbers``, the same one used for the requirements. Give it when ``purpose`` is ``number``; leave it out for ``sms``. | |
| documents | Yes | Map from each needed document slot to ``{option, fields}``, with the option chosen from that slot in the requirements. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| number_id | No | The owned number this registration is for: its ID from ``list_numbers``, the same one used for the requirements. Give it for toll-free texting and when the form asks for the sending number; otherwise leave it out. | |
| number_type | Yes | The kind of number this registration covers. Copy it from the offer in ``quote_numbers`` or the number in ``list_numbers``. | |
| country_code | Yes | ISO 3166-1 alpha-2 country code, such as ``US``. | |
| subject_type | No | Who the registration is for, matching the requirements: the user (``person``) or their company (``business``). It has no default; without it, nothing is sent. | |
| attest_authorized | Yes | Attestation that the named person or business authorized this filing and supplied its details and files. Only ``true`` sends anything. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||