Quote a route
quote_routeRead-onlyIdempotent
Use while the customer is still deciding — "how much is …?": the exact price of ONE eSIM for the whole route — the countries in any order (1–8) with their networks, ONE data pool in GB for all of them and the trip length — the server price the customer would pay. A single country is a route of one. Quote it as returned, never compute, add up or scale it yourself. The result carries a buy_url for reference; when the customer says they want to buy, call start_checkout.
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": {
"route": "<route>",
"days": "<days>"
},
"name": "quote_route"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gb | No | The data pool for the WHOLE route in whole GB (1–100), shared by every country. Omit = sized for normal use (1.5 GB × days). Not sure? Call recommend_config. | |
| days | Yes | Trip length in days (1–90) for the whole route, counted from the first connection anywhere on the route. | |
| route | Yes | The countries of the trip in any order (1–8, each once). | |
| bucket | No | Optional language-region bucket the customer shops in, e.g. en-gb, de-de (sets currency and link locale). Defaults from language. | |
| currency | No | Optional ISO 4217 override for prices. | |
| language | No | ISO language of the conversation, e.g. en, de, ja. Localizes country names and sets the language/currency of links and prices. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Trip length, counted from the first connection anywhere on the route. | |
| note | No | Present when something about the request had to be adjusted — read it to the customer. | |
| price | No | FULL price of this route in currency — the amount paid. Not per day, per GB or per country. | |
| route | No | The countries on the eSIM in any order with the networks of each. | |
| topup | No | How the customer adds data, days or a country later (not through the tools). | |
| buy_url | No | The route builder pre-set to exactly this route. Use verbatim. | |
| data_gb | No | ONE data pool for every country on the route (whole GB), used wherever the customer is. | |
| hotspot | No | ||
| currency | No | ||
| countries | No | ||
| price_basis | No | ||
| not_available | No | Requested countries variotrip cannot add (left out of the quote). | |
| price_is_final | No | ||
| activation_trigger | No | first_connection (anywhere on the route) |