Skip to main content
GET
/
searches
/
{id}
Retrieve a Search
curl --request GET \
  --url https://commerce.driv.ly/api/searches/{id}
{
  "data": {
    "id": "<string>",
    "lead": "<string>",
    "minimumYear": 123,
    "minimumRating": 2.5,
    "maximumYear": 123,
    "maximumPrice": 123,
    "maximumOdometer": 1,
    "vehicleSpecs": [
      "<string>"
    ],
    "vehicles": [
      "<string>"
    ],
    "models": [
      "<string>"
    ],
    "transmissions": [
      "<string>"
    ],
    "drivetrains": [
      "<string>"
    ],
    "makes": [
      "<string>"
    ],
    "bodyStyles": [
      "<string>"
    ],
    "trims": [
      "<string>"
    ]
  },
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.driv.ly/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string
required

Search is uniquely identified by id

Query Parameters

​
depth
integer

The number of levels of related objects to include in the response

Response

Search Found

​
data
Search · object
Example:
{
  "id": "src_5j3ks8d2hj3s",
  "lead": "Lead ID",
  "makes": ["Toyota", "Honda"],
  "trims": ["SE", "EX"],
  "models": ["Camry", "Civic"],
  "vehicles": ["Vehicle ID"],
  "bodyStyles": ["Sedan", "SUV"],
  "minimumYear": 2015,
  "maximumYear": 2021,
  "drivetrains": ["FWD", "AWD"],
  "maximumPrice": 30000,
  "vehicleSpecs": ["Vehicle Spec ID"],
  "minimumRating": 4,
  "transmissions": ["Automatic", "Manual"],
  "maximumOdometer": 50000
}
​
success
boolean