Confirm a verification with a code
confirm_verificationConfirm a registration using the code the carrier sent to the applicant.
Incorrect or expired codes return a field error; the carrier can send a replacement after a day.
Success advances the registration but does not guarantee immediate approval.
A ``confirmation="reply"`` registration requires a direct reply to the carrier's text instead.
Returns the updated registration or 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": {
"verification_id": "<verification_id>",
"code": "<code>"
},
"name": "confirm_verification"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | The code the carrier texted to the applicant's mobile, exactly as the applicant read it out. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| verification_id | Yes | ID of a registration with ``confirmation="code"``, from ``list_verifications`` or ``get_verification``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||