Look up a line to top up
topup_lookupLook up an existing US prepaid line (by phone) or an eSIM (by ICCID / order) and list the top-up plans available for it. Returns product_ids to pass to topup_start.
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": {
"line_type": "<line_type>"
},
"name": "topup_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Customer email (required for esim lookup). | ||
| iccid | No | eSIM ICCID (for esim). | |
| phone | No | US phone number (for us_prepaid). | |
| carrier | No | Carrier name/id (for us_prepaid; see topup carriers). | |
| line_type | Yes | "us_prepaid" for a US phone line, "esim" for a travel eSIM. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| lines | Yes |