IIHS-HLDI API

Complying with the IIHS API Display Requirements

The data in the IIHS API cannot be used to create new, modified, or combined crash test results. Ratings for moderate overlap front, small overlap front, rear, and IIHS TOP SAFETY PICK or IIHS TOP SAFETY PICK+ winners cannot be compared between size classes, because given equivalent ratings heavier vehicles usually offer better protection.

If a vehicle has multiple ratings for a particular test mode, show the one listed as "primary" first. Displaying additional ratings for the test mode is at your discretion.

As of 2017, IIHS has two small overlap front test modes – a driver-side and a passenger-side. Indicate which test mode when displaying either of the small overlap front ratings.

The ratings data also includes information on tested vehicles such as model year, date built, side airbag configuration, and headlight type to ensure that consumers will not be misled about the performance of specific vehicles in safety evaluations. Consequently, there are attributes for several elements in the data that must be incorporated into the display of some ratings in the IIHS API. These attributes and other display requirements are specifically addressed in Section 5 of the IIHS API Terms of Service.

To meet these display requirements you may use the following guidelines, given the current API schema:

Overall and Component Ratings

For a single rating element, display the rating's overallRating value alone or together with all other component rating values present for the rating (e.g. headNeckRating, chestRating, leftLegRating). Do not display an arbitrary subset of component ratings.
Example

The overall moderate overlap front rating for the 2013 Ford Edge is good, but one of its component moderate overlap front ratings is acceptable.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2013/ford/edge
```
<frontalRatingModerateOverlap id="754" iihsUrl="...">
            <overallRating>Good</overallRating>
            <headNeckRating>Acceptable</headNeckRating>
            <chestRating>Good</chestRating>
            <leftLegRating>Good</leftLegRating>
            <rightLegRating>Good</rightLegRating>
            <kinematicsRating>Good</kinematicsRating>
            <structureRating>Good</structureRating>
    <testSubject>2007 Ford Edge SEL Plus 2wd</testSubject>
    <lastModified>...</lastModified>
```
Display examples

OK

2013 Ford Edge

2013 Ford Edge

Structure

Head/neck

Chest

Left leg/foot

Right leg/foot

Restraints

NOT OK

2013 Ford Edge

Structure

Head/neck

2013 Ford Edge

Head/neck

Chest

Left leg/foot

Right leg/foot
Primary Ratings

When displaying a single rating element, first display the overallRating value for the element that has an isPrimary attribute value of true before displaying any other overall rating.
Example

The 2017 Chrysler Pacifica has two frontal small overlap ratings because of a mid-year change to the model. The latest frontal small overlap rating within the model year is considered the primary rating.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2017/chrysler/pacifica-minivan
```
<frontalRatingsSmallOverlap>
  <rating id="13486" iihsUrl="..." isPrimary="true" isQualified="false">
    <builtAfter month="8" year="2016" />
    <overallRating>Good</overallRating>
    <headNeckRating>Good</headNeckRating>
    ...
  </rating>
  <rating id="13484" iihsUrl="..." isPrimary="false" isQualified="false">
    <builtBefore month="9" year="2016" />
    <overallRating>Marginal</overallRating>
    <headNeckRating>Good</headNeckRating>
    ...
  </rating>
</frontalRatingsSmallOverlap>
```
Display examples

OK

2017 Chrysler Pacifica

2017 Chrysler Pacifica

Built after August 2016

2017 Chrysler Pacifica

Built before September 2016

NOT OK

2017 Chrysler Pacifica

2017 Chrysler Pacifica

Built before September 2016

2017 Chrysler Pacifica

Built after August 2016
Small Overlap Front Ratings

When displaying a rating element from the frontalRatingsSmallOverlap collection, include "driver-side" or equivalent language. Likewise, when displaying a rating element from the frontalRatingsSmallOverlapPassenger collection, include "passenger-side" or equivalent language.
Example: Driver-side small overlap front rating

The primary small overlap front rating for the 2018 BMW 5 series only applies to the driver side of the vehicle.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2018/bmw/5-series-4-door-sedan
```
<frontalRatingsSmallOverlap>
  <rating id="16658" iihsUrl="..." isPrimary="true" isQualified="false">
    <overallRating>Good</overallRating>
    ...
  </rating>
</frontalRatingsSmallOverlap>
```
Display examples

OK

2018 BMW 5 series driver-side small overlap front

NOT OK

2018 BMW 5 series small overlap front
Example: Passenger-side small overlap front rating

The primary passenger-side small overlap front rating for the 2018 BMW 5 series only applies to the passenger side of the vehicle.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2018/bmw/5-series-4-door-sedan
```
<frontalRatingsSmallOverlapPassenger>
  <rating id="16663" iihsUrl="..." isPrimary="true" isQualified="false">
    <overallRating>Good</overallRating>
    ...
  </rating>
</frontalRatingsSmallOverlapPassenger>
```
Display examples

OK

2018 BMW 5 series passenger-side small overlap front

NOT OK

2018 BMW 5 series small overlap front
Updated Ratings

When displaying a rating element from the frontalRatingsModerateOverlapUpdated collection, include "updated" or equivalent language. Likewise, when displaying a rating element from the sideRatingsUpdated collection, include "updated" or equivalent language.
Vehicle-to-pedestrian Front Crash Prevention Ratings

When displaying a rating element from the pedestrianAvoidanceRatings collection, include "day" or equivalent language. When displaying a rating element from the pedestrianAvoidanceNightRatings collection, include "night" or equivalent language.
Application of IIHS Top Safety Pick

When a topSafetyPick element is present BUT the element's isTopSafetyPickPlus attribute contains the value false, only apply the year as indicated by the tspYear attribute and the text "IIHS TOP SAFETY PICK," or either of the two IIHS TOP SAFETY PICK logo images, to the specific vehicle indicated by the parent series element’s name attribute. Do not apply the "IIHS TOP SAFETY PICK" text or either of the two year-appropriate IIHS TOP SAFETY PICK logo images to a vehicle if the topSafetyPick element is not present or its isTopSafetyPickPlus attribute contains the value true.
Example

The 2016 IIHS TOP SAFETY PICK award only applies to the 2015 Kia Soul.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2015/kia/soul
```
<results (...) >
  <series id="673" slug="soul" name="Soul" iihsUrl="..." modelYear="2015">
    <make id="202" slug="kia">Kia</make>
    <class id="40" slug="small-cars" iihsUrl="...">small car</class>
            <topSafetyPick isTopSafetyPickPlus="false" tspYear="2016" isQualified="false">
      <lastModified>...</lastModified>
    </topSafetyPick>
```
Display examples

OK

2015 Kia Soul

2015 Kia Soul

2016 IIHS TOP SAFETY PICK

2015 Kia Soul

NOT OK

Kia Soul

2015 Kia Soul

2015 Kia Soul
Application of IIHS Top Safety Pick+

When a topSafetyPick element is present AND the element's isTopSafetyPickPlus attribute contains the value true, only apply the year as indicated by the tspYear attribute and the text "IIHS TOP SAFETY PICK+," or either of the two year-appropriate IIHS TOP SAFETY PICK+ logo images, to the specific vehicle indicated by the parent series element’s name attribute. Do not apply the "IIHS TOP SAFETY PICK+" text or either of the year-appropriate IIHS TOP SAFETY PICK+ logo images to a vehicle if the topSafetyPick element is not present or its isTopSafetyPickPlus attribute contains the value false.
Example

The 2016 IIHS TOP SAFETY PICK+ award applies to the 2015 Volvo S60.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2015/volvo/s60
```
<results (...) >
  <series id="412" slug="s60" name="S60" iihsUrl="..." modelYear="2015">
    <make id="221" slug="volvo">Volvo</make>
    <class id="15" slug="midsize-luxury-near-luxury-cars" iihsUrl="...">midsized luxury/near luxury car</class>
            <topSafetyPick isTopSafetyPickPlus="true" tspYear="2016" isQualified="false">
      <lastModified>...</lastModified>
    </topSafetyPick>
```
Display examples

OK

2015 Volvo S60

2015 Volvo S60

2016 IIHS TOP SAFETY PICK+

2015 Volvo S60

NOT OK

Volvo S60

2015 Volvo S60

2016 IIHS TOP SAFETY PICK

2015 Volvo S60
IIHS Top Safety Pick and IIHS Top Safety Pick+ Qualifications and Built Dates

When displaying a topSafetyPick element whose isQualified attribute contains the value true, display the content of the element's qualifyingText attribute or equivalent language. If the topSafetyPick element contains a builtAfter or builtBefore element, include those month and year values in the display.
Example: Qualifying Text

Only those 2015 Honda CR-V models with optional front crash prevention are a 2016 IIHS TOP SAFETY PICK+.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2015/honda/cr-v
```
<results (...) >
  <series id="307" slug="cr-v" name="CR-V" iihsUrl="..." modelYear="2015">
    <make id="196" slug="honda">Honda</make>
    <class id="58" slug="small-suvs" iihsUrl="...">small SUV</class>
            <topSafetyPick isTopSafetyPickPlus="true" tspYear="2016" isQualified="true" qualifyingText="optional front crash prevention models only">
      <lastModified>...</lastModified>
    </topSafetyPick>
```
Display examples

OK

2015 Honda CR-V

optional front crash prevention models only

2015 Honda CR-V

applies only to optional front crash prevention models

2015 Honda CR-V with front crash prevention

NOT OK

2015 Honda CR-V

Honda CR-V

Honda CR-V with front crash prevention
Example: Built Dates

Only those 2015 Toyota RAV4 models built after November 2014 are 2016 IIHS TOP SAFETY PICK award winners.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2015/toyota/rav4
```
<results (...) >
  <series id="403" slug="rav4" name="RAV4" iihsUrl="..." modelYear="2015">
    <make id="219" slug="toyota">Toyota</make>
    <class id="58" slug="small-SUVs" iihsUrl="...">small SUV</class>
            <topSafetyPick isTopSafetyPickPlus="true" tspYear="2-16" isQualified="true" qualifyingText="Models built after November 2014.">
            <builtAfter month="11" year="2014" />
      <lastModified>...</lastModified>
    </topSafetyPick>
```
Display examples

OK

2015 Toyota RAV4

built after November 2014

2015 Toyota RAV4

models built after Nov. 2014 only

2015 Toyota RAV4 (built after November 2014)

NOT OK

2015 Toyota RAV4

Toyota RAV4

Qualifiying Text for a Single IIHS Rating

When displaying a rating element whose isQualified attribute contains the value true, display the content of the element's qualifyingText attribute or equivalent language.

Example: Optional side airbags

The 2013 Jeep Patriot's primary side rating only applies to models equipped with the additional optional side airbags.

API response

Request URL: http://api.iihs.org/ratings/v4/2013/jeep/patriot-4-door-suv

<sideRatings>
  <rating id="8554" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="with additional optional side airbags">
    <sideAirbagConfiguration>StandardWithAdditionalOptional</sideAirbagConfiguration>
    <sideAirbagDescription>standard front and rear head curtain airbags and optional front seat-mounted torso airbags </sideAirbagDescription>
    <overallRating>Good</overallRating>
    ...

Display examples

OK

2013 Jeep Patriot

with additional optional side airbags

NOT OK

2013 Jeep Patriot

Example: Front crash prevention: vehicle-to-vehicle ratings with optional equipment

The 2017 Subaru Legacy's primary front crash prevention: vehicle-to-vehicle rating only applies to models equipped with the optional autobrake and forward collision warning systems.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2017/subaru/legacy-4-door-sedan

<frontCrashPreventionRatings>
    <rating id="13397" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="with optional equipment">
      <overallRating totalPoints="6">Superior</overallRating>
            <autobrake availability="Optional">
        ...
      </autobrake>
            <forwardCollisionWarning availability="Optional">
        ...
      </forwardCollisionWarning>
    </rating>
</frontCrashPreventionRatings>

Display examples

OK

2017 Subaru Legacy

With optional equipment

NOT OK

2017 Subaru Legacy

Example: Front crash prevention: vehicle-to-pedestrian ratings with optional equipment

The 2019 Mazda CX-5 front crash prevention: vehicle-to-pedestrian rating only applies to models equipped with the optional Smart Brake Support system.

API response

Request URL: https://api.iihs.org/V4/ratings/single/2019/mazda/cx-5-4-door-suv

<pedestrianAvoidanceRatings>
  <rating id="20487" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="with optional equipment">
    <overallRating totalPoints="4">Advanced</overallRating>
    <trimLevels>
        <trim description="Touring" systemName="Smart Brake Support" availability="Optional" />
      ...
    </trimLevels>
  </rating>
</pedestrianAvoidanceRatings>

Display examples

OK

2019 Mazda CX-5

with optional Smart Brake Support

NOT OK

2019 Mazda CX-5

Example: Front crash prevention: vehicle-to-vehicle ratings without autobrake testing

The 2014 Jeep Cherokee has optional autobrake and front crash warning systems, but its primary front crash prevention: vehicle-to-vehicle rating is Basic because the autobrake system was not tested by IIHS.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2014/jeep/cherokee-4-door-suv

<frontCrashPreventionRatings>
  <rating id="2688" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="autobrake not tested, with optional equipment">
    <overallRating totalPoints="1">Basic</overallRating>
    <autobrake availability="Optional">
            <tested>false</tested>
      ...
    </autobrake>
    <forwardCollisionWarning availability="Optional">
      ...
    </forwardCollisionWarning>
  </rating>
</frontCrashPreventionRatings>

Display examples

OK

2014 Jeep Cherokee

Autobrake not tested, with optional equipment

NOT OK

2014 Jeep Cherokee

With optional equipment

2014 Jeep Cherokee

Example: Headlight ratings with optional equipment

The 2017 Toyota Prius v has multiple headlight ratings. The primary rating is for a variant that includes optional high-beam assist as part of the Advanced Technology Package.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2017/toyota/prius-v-4-door-wagon

<results (...) >
  <series id="979" slug="prius-v-4-door-wagon" name="Prius v 4-door wagon" iihsUrl="..." modelYear="2017">
    <make id="219" slug="toyota">Toyota</make>
    ...
    <headlightRatings>
      <headlightRating id="3305" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="with optional equipment">
        <overallRating>Good</overallRating>
        ...
      </headlightRating>
      <headlightRating id="3304" iihsUrl="..." isPrimary="false" isQualified="false">
        <overallRating>Acceptable</overallRating>
        ...
      </headlightRating>
      <headlightRating id="3303" iihsUrl="..." isPrimary="false" isQualified="false">
        <overallRating>Poor</overallRating>
        ...
      </headlightRating>
    </headlightRatings>

Display examples

OK

2017 Toyota Prius v

With optional equipment

NOT OK

2017 Toyota Prius v

Example: Headlight ratings for only certain trims

The 2016 Honda CR-V has two headlight ratings for several different vehicle trims. The primary rating is only for the Touring trim variant.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2016/honda/cr-v-4-door-suv

<headlightRatings>
  <rating id="13275" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="only certain trims">
    <overallRating>Acceptable</overallRating>
    ...
    <trimLevels>
            <trim description="Touring" />
    </trimLevels>
  </rating>
  <rating id="13276" iihsUrl="..." isPrimary="false" isQualified="false">
    <overallRating>Marginal</overallRating>
    ...
    <trimLevels>
      <trim description="LX" />
      <trim description="SE" />
      <trim description="EX" />
      <trim description="EX-L" />
    </trimLevels>
  </rating>
</headlightRatings>

Display examples

OK

2016 Honda CR-V

Only certain trims

NOT OK

2016 Honda CR-V

Vehicle Built Dates

In some cases, ratings apply only to vehicles built before or after a particular month and year. When a rating element contains a builtAfter or builtBefore element, include those month and year values in the display of the rating element.

Example

The 2012 Acura TL rollover rating only applies to models built after September 2011.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2012/acura/tl-4-door-sedan

<results (...) >
  <series id="436" slug="tl-4-door-sedan" name="TL" iihsUrl="..." modelYear="2012">
    <make id="186" slug="acura">Acura</make>
    <class id="15" slug="midsize-luxury-near-luxury-cars" iihsUrl="...">midsize luxury/near luxury car</class>
    <rolloverRating id="1590" iihsUrl="...">
            <builtAfter month="9" year="2011" />
      <overallRating>Good</overallRating>
      <force>17057</force>
      <weight>3710</weight>
      <ratio>4.6</ratio>
      <testSubject>2012 Acura TL 4-door</testSubject>
      <lastModified>2012-10-30T04:15:44.84+00:00</lastModified>
      <photos />
      <videos />
    </rolloverRating>

Display examples

Encouraged

2012 Acura TL

Built after Sept. 2011

Front Crash Prevention Ratings: vehicle-to-vehicle with System and Package Names

When displaying a rating element from the frontCrashPreventionRatings collection, display the text from the systemName and packageName attributes.

Example

The front crash prevention: vehicle-to-vehicle system for the 2017 Audi A3 is called Audi Pre Sense Front.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2016/honda/accord-4-door-sedan

<frontCrashPreventionRatings>
  <rating id="14300" iihsUrl="..." isPrimary="true" isQualified="false">
    <overallRating totalPoints="6">Superior</overallRating>
    <autobrake availability="Standard">
            <systemName>Audi Pre Sense Front</systemName>
      ...
    </autobrake>
    <forwardCollisionWarning availability="Standard">
            <systemName>Audi Pre Sense Front</systemName>
      ...
    </forwardCollisionWarning>
  </rating>
</frontCrashPreventionRatings>

Display examples

Encouraged

2017 Audi A3

with Audi Pre Sense Front

Front Crash Prevention Ratings: vehicle-to-pedestrian with System and Package Names

When displaying a rating element from the pedestrianAvoidanceRatings collection, display the text from the systemName and packageName attributes.
Example

The front crash prevention: vehicle-to-pedestrian system for the 2020 Subaru Forester is called EyeSight Driver-Assist System.

API response

Request URL: https://api.iihs.org/V4/ratings/single/2020/subaru/forester-4-door-suv
```
<pedestrianAvoidanceRatings>
  <rating id="22557" publicRatingId="5215" iihsUrl="..." isPrimary="true" isQualified="false">
    <overallRating totalPoints="5">Superior</overallRating>
    <trimLevels availability="Standard">
        <trim description="" systemName="EyeSight Driver-Assist System" availability="Standard">EyeSight Driver-Assist System</>
      ...
    </trimLevels>
  </rating>
</pedestrianAvoidanceRatings>
```
Display examples

Encouraged

2020 Subaru Forester

with EyeSight Driver-Assist System

Headlight Ratings - Optional Package Details

When displaying a headlightRating element, also display the value of the description attribute and, if present, any text in the optionalPackage attribute of each trim element.

Example

The 2016 Mazda 6 has separate ratings for three different trim/package combinations. To differentiate the three ratings, it's helpful to include trim level and optional package information for each.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2016/mazda/6-4-door-sedan

<results (...) >
  <series id="266" slug="6-4-door-sedan" name="6 4-door sedan" iihsUrl="..." modelYear="2016">
    <make id="206" slug="mazda">Mazda</make>
    <headlightRatings>
      <headlightRating id="3284" iihsUrl="..." isPrimary="true" isQualified="true" qualifyingText="with optional equipment">
        <overallRating>Acceptable</overallRating>
        ...
        <trimLevels>
            <trim description="Grand Touring" optionalPackage="GT Technology" />
        </trimLevels>
      </headlightRating>
      <headlightRating id="3283" iihsUrl="..." isPrimary="false" isQualified="false">
        <overallRating>Acceptable</overallRating>
        ...
        <trimLevels>
            <trim description="Grand Touring" />
            <trim description="Touring" optionalPackage="Touring Technology" />
        </trimLevels>
      </headlightRating>
      <headlightRating id="3282" iihsUrl="..." isPrimary="false" isQualified="false">
        <overallRating>Marginal</overallRating>
        ...
        <trimLevels>
            <trim description="Sport" />
            <trim description="Touring" />
        </trimLevels>
      </headlightRating>
    </headlightRatings>

Display examples

Encouraged

2016 Mazda 6

Grand Touring models with optional GT Technology package

2016 Mazda 6

Grand Touring models

Touring models with optional Touring Technology package

2016 Mazda 6

Sport models

Touring models

Rollover Ratings

When a rating element from the rolloverRatings collection contains a notes element, include the notes element's text, or equivalent language, in the display of the rating element.

Example

The 2016 Volkswagen CC rollover rating does not apply to the 4-wheel drive V6 model.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2011/volkswagen/cc-4-door-sedan

<results (...) >
  <series id="668" slug="cc-4-door-sedan" name="CC" iihsUrl="..." modelYear="2016">
    <make id="220" slug="volkswagen">Volkswagen</make>
    <class id="15" slug="midsize-luxury-near-luxury-cars" iihsUrl="...">midsize luxury/near luxury car</class>
    <rolloverRating id="1524" iihsUrl="...">
      <overallRating>Good</overallRating>
      <force>15057</force>
      <weight>3419</weight>
      <ratio>4.4</ratio>
      <testSubject>2011 Volkswagen CC Lux Limited 4-door</testSubject>
            <notes>Rating does not apply to 4-wheel drive V6 model. Rating of this model is Acceptable.</notes>
      ...
    </rolloverRating>

Display examples

Encouraged

2016 Volkswagen CC

Rating does not apply to 4-wheel drive V6 model

Rear Ratings

When displaying a rearRating element, include the text of that element's seatType element in the display of the rating element.

Example

The 2017 Toyota Camry's rear rating applies only to models equipped with power cloth seats.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2017/toyota/camry-4-door-sedan

<results (...) >
  <series id="291" slug="camry-4-door-sedan" name="Camry" iihsUrl="..." modelYear="2017">
    <make id="219" slug="toyota">Toyota</make>
    <class id="30" slug="midsize-moderately-priced-cars" iihsUrl="...">midsize moderately priced car</class>
    <rearRating id="21238" iihsUrl="...">
      <overallRating>Marginal</overallRating>
      <dynamicRating>Marginal</dynamicRating>
      <geometryRating>Good</geometryRating>
            <seatType>Power cloth seats</seatType>
      ...
    </rearRating>

Display examples

Encouraged

2004 Toyota Camry

Power cloth seats

Tested Vehicle or Seat

When displaying a rating element from the frontRatingsModerateOverlap, frontRatingsSmallOverlap, sideRatings, rolloverRatings or rearRatings collections, preferably include the text of that element's testSubject or seatType element (or equivalent language), a link to the URL in the element's iihsUrl attribute, or a link to the URL in the parent series element's iihsUrl attribute.
Example

The 2009 Mazda Tribute is a sister/twin vehicle to the 2009 Ford Escape XLT, which was the vehicle used in the moderate overlap front test. Even though the tested vehicle is a different make, the series and moderate overlap front rating URLs for the 2009 Mazda Tribute in the API link to Mazda Tribute pages (not Ford Escape pages) on the IIHS website.

API response

Request URL: http://api.iihs.org/v4/ratings/single/2009/mazda/tribute-4-door-suv
```
<results (...) >
  <series id="461" slug="tribute" name="Tribute" iihsUrl="http://www.iihs.org/ratings/vehicle/mazda/tribute-4-door-suv" 
                modelYear="2009">
    <make id="206" slug="mazda">Mazda</make>
    <class id="58" slug="small-suvs" iihsUrl="http://www.iihs.org/ratings/class-summary/small-suvs">small SUV</class>
    <frontalRatingModerateOverlap id="1022" iihsUrl="http://www.iihs.org/ratings/vehicle/mazda/tribute-4-door-suv/2009#Frontal5734"> 
      <overallRating>Good</overallRating>
      <headNeckRating>Good</headNeckRating>
      <chestRating>Good</chestRating>
      <leftLegRating>Good</leftLegRating>
      <rightLegRating>Acceptable</rightLegRating>
      <kinematicsRating>Good</kinematicsRating>
      <structureRating>Good</structureRating>
            <testSubject>2009 Ford Escape XLT 4wd </testSubject>
      <lastModified>2012-06-27T14:23:06.07+00:00</lastModified>
```
Display examples

Encouraged

2009 Mazda Tribute

Tested vehicle: 2009 Ford Escape XLT 4WD

2009 Mazda Tribute

More information
Additional Requirements

Additional display requirements outlined in Section 5 of the Terms of Service include:
- Displaying "Ratings only apply to model tested. Date of manufacture and optional safety equipment can affect results. For full details see www.iihs.org." or equivalent language,
- Not modifying, combining, or creating new crash test ratings, and
- Not displaying, recommending, or suggesting the comparison of moderate overlap front ratings, small overlap front ratings, rear ratings, IIHS TOP SAFETY PICK winners, or IIHS TOP SAFETY PICK+ winners from different size classes.

General

Version 4

Version 3

Version 2

Complying with the IIHS API Display Requirements

Overall and Component Ratings

Example

API response

Display examples

OK

G 2013 Ford Edge

G 2013 Ford Edge

NOT OK

2013 Ford Edge

G 2013 Ford Edge

Primary Ratings

Example

API response

Display examples

OK

G 2017 Chrysler Pacifica

G 2017 Chrysler Pacifica

M 2017 Chrysler Pacifica

NOT OK

M 2017 Chrysler Pacifica

M 2017 Chrysler Pacifica

G 2017 Chrysler Pacifica

Small Overlap Front Ratings

Example: Driver-side small overlap front rating

API response

Display examples

OK

G 2018 BMW 5 series driver-side small overlap front

NOT OK

G 2018 BMW 5 series small overlap front

Example: Passenger-side small overlap front rating

API response

Display examples

OK

G 2018 BMW 5 series passenger-side small overlap front

NOT OK

G 2018 BMW 5 series small overlap front

Updated Ratings

Vehicle-to-pedestrian Front Crash Prevention Ratings

Application of IIHS Top Safety Pick

Example

API response

Display examples

OK

2015 Kia Soul

2015 Kia Soul

2016 IIHS TOP SAFETY PICK

NOT OK

Kia Soul

2015 Kia Soul

2015 Kia Soul

Application of IIHS Top Safety Pick+

Example

API response

Display examples

OK

2015 Volvo S60

2015 Volvo S60

2016 IIHS TOP SAFETY PICK+

NOT OK

Volvo S60

2015 Volvo S60

2016 IIHS TOP SAFETY PICK

IIHS Top Safety Pick and IIHS Top Safety Pick+ Qualifications and Built Dates

Example: Qualifying Text

API response

Display examples

OK

2015 Honda CR-V

2015 Honda CR-V

2015 Honda CR-V with front crash prevention

NOT OK

2015 Honda CR-V

Honda CR-V

Honda CR-V with front crash prevention

2013 Ford Edge

2013 Ford Edge

2013 Ford Edge

2017 Chrysler Pacifica

2017 Chrysler Pacifica

2017 Chrysler Pacifica

2017 Chrysler Pacifica

2017 Chrysler Pacifica

2017 Chrysler Pacifica

2018 BMW 5 series driver-side small overlap front

2018 BMW 5 series small overlap front

2018 BMW 5 series passenger-side small overlap front

2018 BMW 5 series small overlap front

2013 Jeep Patriot

2013 Jeep Patriot

2017 Toyota Prius v

2017 Toyota Prius v

2016 Honda CR-V

2016 Honda CR-V

2012 Acura TL