Skip to main content
POST
/
searches
Create a new Search
curl --request POST \
  --url https://commerce.driv.ly/api/searches \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "updatedAt": "<string>",
  "createdAt": "<string>",
  "lead": 123,
  "status": "On Hold",
  "retailListingUrls": "<string>",
  "year": "<string>",
  "make": "<string>",
  "model": "<string>",
  "trim": "<string>",
  "bodyStyle": [
    "car"
  ],
  "drive": [
    "4WD"
  ],
  "transmission": [
    "Manual"
  ],
  "maxPrice": "<string>",
  "maxMiles": 123,
  "newOrUsed": [
    "New"
  ],
  "minimumGrade": 123,
  "requiredOptions": [
    "Heated Seats"
  ],
  "acceptableColors": [
    "Anti-Black"
  ],
  "acceptableInterior": [
    "Beige"
  ],
  "proposedVehicles": "<string>",
  "vehicles": [
    123
  ],
  "lastModifiedBy": 123,
  "seats": "<string>",
  "updateRequested": "<string>",
  "oneOwner": true,
  "priority": true
}
'
{
  "doc": {
    "updatedAt": "<string>",
    "createdAt": "<string>",
    "lead": 123,
    "status": "On Hold",
    "retailListingUrls": "<string>",
    "year": "<string>",
    "make": "<string>",
    "model": "<string>",
    "trim": "<string>",
    "bodyStyle": [
      "car"
    ],
    "drive": [
      "4WD"
    ],
    "transmission": [
      "Manual"
    ],
    "maxPrice": "<string>",
    "maxMiles": 123,
    "newOrUsed": [
      "New"
    ],
    "minimumGrade": 123,
    "requiredOptions": [
      "Heated Seats"
    ],
    "acceptableColors": [
      "Anti-Black"
    ],
    "acceptableInterior": [
      "Beige"
    ],
    "proposedVehicles": "<string>",
    "vehicles": [
      123
    ],
    "lastModifiedBy": 123,
    "seats": "<string>",
    "updateRequested": "<string>",
    "oneOwner": true,
    "priority": true
  },
  "message": "<string>"
}
Make sure you install our SDK first. You can find out how, and more here.
import { SDK } from '@drivly/commerce'
import type { searches } from '@drivly/commerce'

const sdk = new SDK(...)

const searches = await sdk.searches.create(data: searches): Promise<searches>

Authorizations

​
Authorization
string
header
required

Query Parameters

​
depth
number

number of levels to automatically populate relationships and uploads

​
locale
string

retrieves document(s) in a specific locale

​
fallback-locale
string

specifies a fallback locale if no locale value exists

Body

application/json
​
updatedAt
string
required
​
createdAt
string
required
​
lead
​
status
enum<string> | null
Available options:
On Hold,
Searching,
Results Found,
Search Cancelled
​
retailListingUrls
string | null
​
year
string | null
​
make
string | null
​
model
string | null
​
trim
string | null
​
bodyStyle
enum<string>[] | null
Available options:
car,
suv,
truck,
van,
wagon
​
drive
enum<string>[] | null
Available options:
4WD,
AWD,
2WD
​
transmission
enum<string>[] | null
Available options:
Manual,
Automatic
​
maxPrice
string | null
​
maxMiles
number | null
​
newOrUsed
enum<string>[] | null
Available options:
New,
Certified,
Used
​
minimumGrade
number | null
​
requiredOptions
enum<string>[] | null
Available options:
Heated Seats,
No crazy colors,
Tow package,
Heated wheel,
Panoramic sunroof,
Leather Seats,
Bluetooth,
Backup Camera,
Apple Play,
Cooled Seats
​
acceptableColors
enum<string>[] | null
Available options:
Anti-Black,
Anti-Gray,
Anti-Red,
Anti-Silver,
Anti-White,
Beige,
Black,
Blue,
Brown,
Gold,
Gray,
Green,
Light Blue,
Orange,
Red,
Silver,
White,
Yellow
​
acceptableInterior
enum<string>[] | null
Available options:
Beige,
Black,
Brown,
Cream,
Gray,
Ivory,
Red,
Tan,
White,
Blue,
Burgundy,
Charcoal,
Off-White
​
proposedVehicles
string | null
​
vehicles
(number | Vehicle · object)[] | null
​
lastModifiedBy
number
​
seats
string | null
​
updateRequested
string | null
​
oneOwner
boolean | null
​
priority
boolean | null

Response

200 - application/json

ok

​
doc
Search · object
required
​
message
string
required