Preview the request
requests_previewShows what requests_submit would do, and contacts no dealership. It also shows what a new-car request would do, after see_car_choices. It returns the request as given, what happens next, and a previewToken that works for 15 minutes, for this exact request and idempotencyKey only. requests_submit takes this previewToken.
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": {
"idempotencyKey": "<idempotencyKey>",
"zip": "<zip>"
},
"name": "requests_preview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | Yes | The buyer's five-digit US ZIP code, as the buyer gave it. The request goes to dealerships near this ZIP. Do not guess it. | |
| limit | No | How many dealerships the buyer wants Ridekick to contact, at most 5. | |
| replaces | No | The previewToken that expired for this same request. The answer then carries `sameFacts` and `silentOk`. When `silentOk` is true, the buyer's earlier yes still covers this request and the new `previewToken` can be sent with the same `idempotencyKey` as before. | |
| consentId | No | The id of the consent words the card drew for this tap. Sent only by the card. | |
| listingId | No | Optional. The car the buyer chose: the listingId from see_cars_near_buyer, or the reference after "Ridekick reference: " in the buyer's message, such as 7K4M-2QPX, as written. Sent with zip, and without configuration, radiusMiles, limit or acceptFewer. Valid for 24 hours for this buyer. A car found by a new search has a new listingId, and a new listingId comes with a new idempotencyKey. | |
| acceptFewer | No | False: if fewer dealerships match than the limit, nothing is sent and you are told. True: go ahead with the fewer. | |
| radiusMiles | No | How far from the buyer's ZIP code to look for dealerships, in miles. | |
| configuration | No | The car the buyer asked about and confirmed. Sent instead of listingId. The request names the car with these fields as given. Use only what the buyer told you; do not guess a field. | |
| paymentMethod | No | Optional. How the buyer said they plan to pay: cash, finance, lease, or not_sure. Ridekick stores it with the request. | |
| idempotencyKey | Yes | A key you make up for this one request. The same key sent again with the same request never sends it twice. |