General

Overview Authentication Terms of Service Privacy Notice Display requirements Version history

Version 4

Model years Vehicle makes Vehicle classes Vehicle series All vehicle makes All vehicle classes All vehicle series Makes and models for class Vehicle models for make Series for make and model Model years for series Single series All ratings Example

Version 3

Model years Vehicle makes Vehicle series Single series All series

Version 2

Model years Vehicle makes Vehicle series Single series All series

Understanding the IIHS API

The IIHS API provides a simple way for approved developers to incorporate IIHS ratings, video, photos, and other data into their own application or website.

Request syntax

Requests to the API are issued as standard HTTP or HTTPS GET requests. Refer to the links on the left side of this page for a list of supported request methods (URLs) and information on their use.

In addition to any parameters required by each method, all API requests must include authentication parameters to verify that the request is from an authorized application. Refer to the authentication page for specific instructions.

Response formats

The IIHS API returns text-based data in either JSON or XML format, depending on the Accept header provided by the client. You can override the format indicated by the Accept header by adding format=json or format=xml to the querystring of your request URL (this can be useful when using a web browser to preview the response or download it to a file).