Get verification requirements
get_verification_requirementsRead a carrier's current registration fields, documents, address rules and fees.
The response's ``subject_types`` lists the applicant types the carrier accepts.
US local SMS registration uses ``purpose="sms"``, country ``US`` and type ``local``.
Toll-free verification uses ``purpose="sms"``, the number's country ``US`` or ``CA``,
type ``toll_free`` and its owned ``number_id``. Each number needs its own verification.
Applicant country and business tax status determine the registration route.
The personal route is available to US or Canadian applicants without a business tax number.
Local 10DLC fees apply at submission, carrier review and monthly after approval.
Toll-free verification is free and sends no identity confirmation code.
Returns ``required``, ``fields``, ``documents`` and ``address_required``.
``required=false`` means a registration submission is unnecessary and would fail.
Fields and files require accurate information supplied by the authorized applicant.
Choice fields accept comma-separated option keys within their ``min_choices`` and ``max_choices``.
Field ``max_length`` uses UTF-16 code units; an emoji counts as two.
Selected consent methods can require evidence even when shared fields are optional.
Document slots with ``needs_input=false`` require no upload.
An upstream failure returns an error.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>",
"subject_type": "<subject_type>"
},
"name": "get_verification_requirements"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 offer to register for: its ``quote_id`` from ``quote_numbers``, which selects that offer's form. Give it when ``purpose`` is ``number``; leave it out for ``sms``. | |
| 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 | Yes | Who the registration is for: the user themselves (``person``) or their company (``business``). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||