Fetch IMS Inventory

curl --request GET \
  --url https://api.autosnap.com/v1/ims/vehicles

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.autosnap.com/v1/ims/vehicles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.autosnap.com/v1/ims/vehicles"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.autosnap.com/v1/ims/vehicles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

GET

ims

vehicles

Fetch IMS Inventory

curl --request GET \
  --url https://api.autosnap.com/v1/ims/vehicles

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.autosnap.com/v1/ims/vehicles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.autosnap.com/v1/ims/vehicles"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.autosnap.com/v1/ims/vehicles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

GET /v1/ims/vehicles Returns active vehicles from IMS feed imports for a dealership. Supports filtering by condition, make, model, and year range. Paginated.

Parameters

Name	Type	In	Required	Default	Description
`api_key`	string	query	Yes	—	Your API key
`dealership_id`	string	query	Yes	—	Dealership public ID (e.g., `dlr_8cfc0b00a98b`)
`condition`	string	query	No	—	Filter by condition: `New`, `Used`, or `Certified`
`make`	string	query	No	—	Filter by make (case-insensitive)
`model`	string	query	No	—	Filter by model (case-insensitive)
`year_min`	integer	query	No	—	Minimum model year
`year_max`	integer	query	No	—	Maximum model year
`page`	integer	query	No	`1`	Page number (1-indexed)
`per_page`	integer	query	No	`100`	Results per page (max 500)
`format`	string	query	No	`default`	Response format: `default` (IMS native fields) or `normalized` (maps to same field names as website vehicle data from `POST /v1/inventory/fetch`)

Example

curl "https://api.autosnap.com/v1/ims/vehicles?api_key=YOUR_API_KEY&dealership_id=dlr_8cfc0b00a98b&condition=Used&per_page=50"

Response

{
  "vehicles": [
    {
      "id": 42,
      "vin": "1GCHSCEA7L1214921",
      "stock_number": "M1382",
      "condition": "Used",
      "certified": false,
      "year": 2020,
      "make": "Chevrolet",
      "model": "Colorado 2WD",
      "trim": "Ext Cab LT",
      "body": null,
      "doors": null,
      "exterior_color": "WHITE",
      "interior_color": "BLACK",
      "odometer": 41899,
      "engine": null,
      "engine_cylinders": null,
      "transmission": "Automatic",
      "drivetrain": "2WD",
      "fuel_type": null,
      "city_mpg": 0,
      "highway_mpg": 0,
      "msrp": 0.0,
      "price": 0.0,
      "internet_price": 18999.0,
      "invoice": null,
      "book_value": null,
      "model_number": null,
      "description": "Carfax vehicle history report available...",
      "features": "2WD|ABS (4-Wheel)|AM/FM/HD Radio|...",
      "photo_urls": "https://imageserver.promaxinventory.com/...|https://...",
      "vdp_url": "https://www.preownedplus.com/VehicleDetails/...",
      "inventory_date": "2025-09-09",
      "days_in_stock": null,
      "series_detail": null,
      "video_url": null,
      "cab_type": null,
      "carfax_one_owner": null,
      "certification_program": null,
      "created_at": "2026-04-14T06:15:00+00:00",
      "updated_at": "2026-04-14T06:15:00+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 87,
    "total_pages": 2
  }
}

Photo URLs and features are stored as pipe-delimited (|) strings. Split on | to get individual items.

Normalized Format

Use format=normalized to get the same field names as website-scraped vehicles from POST /v1/inventory/fetch. This lets you process both data sources with the same code.

When using format=normalized, the field names match the website inventory schema. However, some fields have different data types:

photo_url_list: A pipe-delimited string of URLs (e.g., "https://img1.jpg|https://img2.jpg") rather than the JSON array of objects returned by the website fetch endpoint.
features: A pipe-delimited string (e.g., "AWD|Leather|Sunroof") rather than a JSON array.

Parse these fields by splitting on the | character.

curl "https://api.autosnap.com/v1/ims/vehicles?api_key=YOUR_API_KEY&dealership_id=dlr_8cfc0b00a98b&format=normalized&per_page=1"

{
  "vehicles": [
    {
      "id": 42,
      "vin": "1GCHSCEA7L1214921",
      "stocknum": "M1382",
      "condition": "Used",
      "certified": false,
      "year": 2020,
      "make": "Chevrolet",
      "model": "Colorado 2WD",
      "series": "Ext Cab LT",
      "body": null,
      "door_count": null,
      "exterior_color": "WHITE",
      "interior_color": "BLACK",
      "odometer": 41899,
      "engine": null,
      "engine_cyl_count": null,
      "engine_displacement": null,
      "transmission": "Automatic",
      "drivetrain_desc": "2WD",
      "fuel": null,
      "city_mpg": 0,
      "hwy_mpg": 0,
      "msrp": 0.0,
      "price": 0.0,
      "internet_price": 18999.0,
      "invoice_price": null,
      "book_value": null,
      "model_num": null,
      "vdp_link": "https://www.preownedplus.com/VehicleDetails/...",
      "photo_url_list": "https://imageserver...|https://...",
      "inventory_date": "2025-09-09",
      "age_days": null,
      "first_seen_at": "2026-04-14T06:15:00+00:00",
      "last_seen": "2026-04-14T06:15:00+00:00",
      "source": "ims"
    }
  ],
  "pagination": { "page": 1, "per_page": 1, "total": 87, "total_pages": 87 }
}

Field Mapping (IMS → Normalized)

IMS Field	Normalized Field	Notes
`stock_number`	`stocknum`
`trim`	`series`
`doors`	`door_count`
`engine_cylinders`	`engine_cyl_count`
`drivetrain`	`drivetrain_desc`
`fuel_type`	`fuel`
`highway_mpg`	`hwy_mpg`
`invoice`	`invoice_price`
`model_number`	`model_num`
`vdp_url`	`vdp_link`
`photo_urls`	`photo_url_list`
`days_in_stock`	`age_days`
`carfax_one_owner`	`carfax_1_owner`
`series_detail`	`series_detail`	Passed through unchanged
—	`carfax_clean_title`	Always `null` (not available in IMS feeds)
—	`dealership_active`	Always `true` for active IMS vehicles
—	`source`	Always `"ims"` in normalized format

Fields that exist in the website schema but have no IMS equivalent (e.g., heading, price_components, in_transit) are returned as null.

Errors

Status	Detail	Cause
`403`	`Not authorized for this dealership`	Your API key doesn’t have access to this dealership
`404`	`Dealership not found`	Invalid dealership_id

Query Parameters

api_key

string

required

dealership_id

string

required

Public ID (e.g. dlr_xxx) or internal ID

condition

string | null

Filter: New, Used, or Certified

make

string | null

model

string | null

year_min

integer | null

year_max

integer | null

page

integer

default:1

per_page

integer

default:100

Max 500

format

enum<string>

default:default

Response format. "default" returns IMS native fields. "normalized" maps fields to match the website vehicle schema (same as POST /v1/inventory/fetch).

Available options:

default,

normalized

Response

Successful Response

Fetch Website Inventory Search Vehicles

API Reference

Dealers

Inventory

Semantic Search

Feed Management

Webhooks

Account

Fetch IMS Inventory

Parameters

Example

Response

Normalized Format

Field Mapping (IMS → Normalized)

Errors

Query Parameters

Response

​Parameters

​Example

​Response

​Normalized Format

​Field Mapping (IMS → Normalized)

​Errors

Query Parameters

Response

Parameters

Example

Response

Normalized Format

Field Mapping (IMS → Normalized)

Errors