---
title: "NCAP ratings for a model year"
method: GET
path: "/v2/safety/{ref}"
tags: ["safety"]
---

# NCAP ratings for a model year

`GET /v2/safety/{ref}`

## Request

- Base URL: `https://api.cardog.app`
- URL: `https://api.cardog.app/v2/safety/{ref}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Path parameters

- `ref` string, required

## Response `200`

Rated configurations + the headline rating

- Safety
  - `modelYearRef` string, required: Entity ref ({domain}:{key}) in the "model-year" domain. Example: "model-year:toyota/rav4/2021"
  - `best` object, nullable, required
    - `ref` string, required: Ref of this rating. One rating exists per rated configuration (body style, drivetrain, variant, production release), so cite this ref rather than the model year.
    - `modelYearRef` string, required: Entity ref ({domain}:{key}) in the "model-year" domain. Example: "model-year:toyota/rav4/2021"
    - `makeRef` string, nullable, required: Entity ref ({domain}:{key}) in the "make" domain. Example: "make:toyota"
    - `modelRef` string, nullable, required: Entity ref ({domain}:{key}) in the "model" domain. Example: "model:toyota/rav4"
    - `year` integer, required
    - `make` string, nullable, required: Display name, derived from makeRef
    - `model` string, nullable, required: Display name, derived from modelRef
    - `config` object, required
      - `bodyStyleRef` string, nullable, required: Body-style entity ref, e.g. "body-style:pickup"
      - `bodyCabRef` string, nullable, required: Cab configuration entity ref for pickups, e.g. "body-cab:crew-super-crew-crew-max"
      - `driveTypeRefs` string[], nullable, required
      - `fuelTypeRef` string, nullable, required
      - `electrificationLevelRef` string, nullable, required
      - `nhtsaClass` 'passenger-car' | 'suv' | 'truck' | 'van' | 'bus', nullable, required
      - `nhtsaSizeClass` 'mini' | 'light' | 'compact' | 'medium' | 'heavy', nullable, required
      - `variant` string, nullable, required
    - `crash` object, required
      - `overall` object, required
        - `stars` integer, nullable, required
        - `outOf` 5, required
      - `frontal` object, required
        - `overall` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `driver` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `passenger` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `side` object, required
        - `overall` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `driver` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `passenger` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `barrier` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `pole` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `combined` object, required
        - `front` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `rear` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `rollover` object, required
        - `stars` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `possibility` object, nullable, required
          - `value` number, required
          - `unitCode` string, required
        - `staticStabilityFactor` object, nullable, required
          - `value` number, required
          - `unitCode` string, required
        - `dynamicTip` 'no-tip' | 'tip' | 'not-tested', nullable, required
    - `equipment` object, required
    - `published` object, required
      - `bodyStyle` string, nullable, required
      - `driveTrain` string, nullable, required
      - `vehicleClass` string, nullable, required
      - `vehicleType` string, nullable, required
      - `dynamicTipResult` string, nullable, required
      - `rolloverPossibility` number, nullable, required
      - `abs` string, nullable, required
      - `esc` string, nullable, required
      - `backupCamera` string, nullable, required
      - `blindSpotDetection` string, nullable, required
      - `frontCollisionWarning` string, nullable, required
      - `laneDepartureWarning` string, nullable, required
      - `crashImminentBrake` string, nullable, required
      - `dynamicBrakeSupport` string, nullable, required
      - `headSideAirbag` string, nullable, required
      - `torsoSideAirbag` string, nullable, required
    - `provenance` object, required
      - `sourceRef` string, required
      - `productionRelease` integer, required
    - `tested` boolean
  - `ratings` object[], required
    - `ref` string, required: Ref of this rating. One rating exists per rated configuration (body style, drivetrain, variant, production release), so cite this ref rather than the model year.
    - `modelYearRef` string, required: Entity ref ({domain}:{key}) in the "model-year" domain. Example: "model-year:toyota/rav4/2021"
    - `makeRef` string, nullable, required: Entity ref ({domain}:{key}) in the "make" domain. Example: "make:toyota"
    - `modelRef` string, nullable, required: Entity ref ({domain}:{key}) in the "model" domain. Example: "model:toyota/rav4"
    - `year` integer, required
    - `make` string, nullable, required: Display name, derived from makeRef
    - `model` string, nullable, required: Display name, derived from modelRef
    - `config` object, required
      - `bodyStyleRef` string, nullable, required: Body-style entity ref, e.g. "body-style:pickup"
      - `bodyCabRef` string, nullable, required: Cab configuration entity ref for pickups, e.g. "body-cab:crew-super-crew-crew-max"
      - `driveTypeRefs` string[], nullable, required
      - `fuelTypeRef` string, nullable, required
      - `electrificationLevelRef` string, nullable, required
      - `nhtsaClass` 'passenger-car' | 'suv' | 'truck' | 'van' | 'bus', nullable, required
      - `nhtsaSizeClass` 'mini' | 'light' | 'compact' | 'medium' | 'heavy', nullable, required
      - `variant` string, nullable, required
    - `crash` object, required
      - `overall` object, required
        - `stars` integer, nullable, required
        - `outOf` 5, required
      - `frontal` object, required
        - `overall` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `driver` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `passenger` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `side` object, required
        - `overall` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `driver` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `passenger` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `barrier` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `pole` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `combined` object, required
        - `front` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `rear` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
      - `rollover` object, required
        - `stars` object, required
          - `stars` integer, nullable, required
          - `outOf` 5, required
        - `possibility` object, nullable, required
          - `value` number, required
          - `unitCode` string, required
        - `staticStabilityFactor` object, nullable, required
          - `value` number, required
          - `unitCode` string, required
        - `dynamicTip` 'no-tip' | 'tip' | 'not-tested', nullable, required
    - `equipment` object, required
    - `published` object, required
      - `bodyStyle` string, nullable, required
      - `driveTrain` string, nullable, required
      - `vehicleClass` string, nullable, required
      - `vehicleType` string, nullable, required
      - `dynamicTipResult` string, nullable, required
      - `rolloverPossibility` number, nullable, required
      - `abs` string, nullable, required
      - `esc` string, nullable, required
      - `backupCamera` string, nullable, required
      - `blindSpotDetection` string, nullable, required
      - `frontCollisionWarning` string, nullable, required
      - `laneDepartureWarning` string, nullable, required
      - `crashImminentBrake` string, nullable, required
      - `dynamicBrakeSupport` string, nullable, required
      - `headSideAirbag` string, nullable, required
      - `torsoSideAirbag` string, nullable, required
    - `provenance` object, required
      - `sourceRef` string, required
      - `productionRelease` integer, required
    - `tested` boolean
  - `links` object: Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

## Other responses

- `400`: Invalid request — grammar failure or unknown-but-well-formed refs, NAMED in `refs`/`details`, with nearest-ref `suggestions` where computable. Never a fuzzy fallback.
- `401`: No valid credential (API key, session, or internal token)
- `404`: Resource not found
- `429`: Per-minute rate limit exceeded
- `500`: Internal error

---

[API](https://skmtc.dev/cardog/apis/cardog-api-v2.md) · [All operations](https://skmtc.dev/cardog/apis/cardog-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/cardog/apis/cardog-api-v2/revisions/b9d48193126f?raw)