Get an order
get_orderCheck an order by its id: status (awaiting_payment, paid, fulfilled, expired ...), price and, once fulfilled, the first 25 leads plus download links for the whole set. Use it after a person has paid a checkout link. Nothing is charged.
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": {
"order_id": "<order_id>"
},
"name": "get_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | The order id returned by buy_leads, like "ord_...". Keep it secret: it grants the download. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| leads | Yes | At most 25 leads, only when fulfilled. Use the download links for the full set. | |
| notes | No | Plain sentences from the API about this order, for example that the same search already has an unpaid order. | |
| status | Yes | awaiting_payment, paid, fulfilled, expired, canceled, refunded or failed. | |
| matched | No | ||
| paid_at | No | ||
| currency | No | ||
| download | No | ||
| livemode | No | ||
| order_id | Yes | The order id. Keep it secret. | |
| quantity | No | ||
| delivered | No | ||
| next_step | Yes | What to do next, in plain words. | |
| price_usd | No | ||
| created_at | No | ||
| expires_at | No | ||
| leads_shown | Yes | ||
| leads_total | Yes | How many leads the order holds. | |
| price_cents | No | ||
| checkout_url | No | Open this page to pay (a person must do it). | |
| next_after_id | No | ||
| payment_method | No | ||
| leads_truncated | Yes | True when more leads exist than the 25 shown inline. | |
| url_elicitation | No | Whether the checkout link was also offered through URL-mode elicitation. | |
| unit_price_cents | No |