US Department of Transportation · Example Payload

Nhtsa Datasets Api Examples

GovernmentTransportationTruckingAviationVehicleSafetyTransitOpenData

Nhtsa Datasets Api Examples is an example object payload from US Department of Transportation, with 44 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

get-childSeatsget-childSeats-bySearchget-childSeats-inspectionStationsget-childSeats-inspectionStations-statesget-childSeats-manufacturersget-childSeats-modesget-childSeats-{id}get-equipmentget-equipment-brandsget-equipment-bySearchget-equipment-{id}get-ewr-damagesget-ewr-injuriesget-ewr-manufacturersget-ewr-manufacturers-{id}get-ewr-productionsget-foreignCampaignsget-foreignCampaigns-manufacturersget-foreignCampaigns-{id}get-safetyIssuesget-safetyIssues-byDateget-safetyIssues-byKeywordsget-safetyIssues-byNhtsaIdget-tiresget-tires-brandsget-tires-bySearchget-tires-{id}get-vehiclesget-vehicles-byArtemisIdget-vehicles-byMultipleArtemisIdsget-vehicles-byClassget-vehicles-byIdsget-vehicles-byManufacturerget-vehicles-byNcapIdget-vehicles-bySearchget-vehicles-byVinget-vehicles-byYmmtget-vehicles-classesget-vehicles-makesget-vehicles-manufacturersget-vehicles-modelYearsget-vehicles-modelsget-vehicles-trimsget-vehicles-{id}-details

Example Payload

Raw ↑
{
  "get-childSeats": {
    "operationId": "get-childSeats",
    "method": "GET",
    "path": "/childSeats",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (modes, complaints, recalls, investigations, manufacturerCommunications).",
        "type": "string"
      },
      {
        "name": "dataSet",
        "in": "query",
        "required": false,
        "description": "Select which data set to return, either \"ratings\" or \"safetyIssues\". Defaults to 'all'",
        "type": "string"
      },
      {
        "name": "weight",
        "in": "query",
        "required": false,
        "description": "Child weight for any childSeat mode",
        "type": "string"
      },
      {
        "name": "height",
        "in": "query",
        "required": false,
        "description": "Child height for any childSeat mode",
        "type": "string"
      },
      {
        "name": "age",
        "in": "query",
        "required": false,
        "description": "Child age for any childSeat mode",
        "type": "string"
      },
      {
        "name": "modelName",
        "in": "query",
        "required": false,
        "description": "Child height for any childSeat mode",
        "type": "string"
      },
      {
        "name": "manufacturerName",
        "in": "query",
        "required": false,
        "description": "Returns child seats based on model",
        "type": "string"
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": "order",
        "in": "query",
        "required": false,
        "description": "order in which to sort",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records set to return for pagination.",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns zero or more childSeats",
        "schema": {
          "items": {
            "$ref": "#/definitions/ChildseatWrapped"
          },
          "title": "ArrayOfChildSeats",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-bySearch": {
    "operationId": "get-childSeats-bySearch",
    "method": "GET",
    "path": "/childSeats/bySearch",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "query",
        "in": "query",
        "required": true,
        "description": "returns zero or more child seats based on search query",
        "type": "string"
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": "order",
        "in": "query",
        "required": false,
        "description": "order in which to sort",
        "type": "string"
      },
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (modes, complaints, recalls, investigations, manufacturercommunications).",
        "type": "string"
      },
      {
        "name": "dataSet",
        "in": "query",
        "required": false,
        "description": "Select which data set to return, either \"ratings\" or \"safetyIssues\". Defaults to 'all'",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Fuzzy search for a child seat based on make, productModel, and modelNumber",
        "schema": {
          "$ref": "#/definitions/ChildseatWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-inspectionStations": {
    "operationId": "get-childSeats-inspectionStations",
    "method": "GET",
    "path": "/childSeats/inspectionStations",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "usState",
        "in": "query",
        "required": false,
        "description": "returns inspections stations within provided usState; use states provided by /carseats",
        "type": "string"
      },
      {
        "name": "latitude",
        "in": "query",
        "required": false,
        "description": "latitude of the child seat inspection stations overrides usState query param",
        "type": "string"
      },
      {
        "name": "longitude",
        "in": "query",
        "required": false,
        "description": "longtiude of the child seat inspection stations overrides usState query param",
        "type": "string"
      },
      {
        "name": "distance",
        "in": "query",
        "required": false,
        "description": "maximum distance to search for an inspection station",
        "type": "number"
      },
      {
        "name": "onlySpanishSpeaking",
        "in": "query",
        "required": false,
        "description": "only return inspection stations that have spanish speaking contacts",
        "type": "boolean"
      },
      {
        "name": "onlyWithEvent",
        "in": "query",
        "required": false,
        "description": "only return inspection statings that have an event associated with them",
        "type": "boolean"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return. Use '-1' to get all records.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns zero or more inspections stations based on queries provided",
        "schema": {
          "$ref": "#/definitions/InspectionStationDetailsWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-inspectionStations-states": {
    "operationId": "get-childSeats-inspectionStations-states",
    "method": "GET",
    "path": "/childSeats/inspectionStations/states",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return. Use '-1' to get all records.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns all states with inspection stations",
        "schema": {
          "$ref": "#/definitions/PartialChildSeatWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-manufacturers": {
    "operationId": "get-childSeats-manufacturers",
    "method": "GET",
    "path": "/childSeats/manufacturers",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "dataSet",
        "in": "query",
        "required": false,
        "description": "Select which data set to return, either \"ratings\" or \"safetyIssues\". Defaults to 'all'",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return. Use '-1' to get all records.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns all available child seat manufacturers",
        "schema": {
          "$ref": "#/definitions/PartialChildSeatWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-modes": {
    "operationId": "get-childSeats-modes",
    "method": "GET",
    "path": "/childSeats/modes",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [],
    "responses": {
      "200": {
        "description": "Returns list of child seat modes and their recommended age range in years",
        "schema": {
          "$ref": "#/definitions/PartialChildSeatWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-childSeats-{id}": {
    "operationId": "get-childSeats-{id}",
    "method": "GET",
    "path": "/childSeats/{id}",
    "summary": "",
    "tags": [
      "childSeats"
    ],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "ID of the child seat",
        "type": "integer"
      },
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (modes, complaints, recalls, investigations, manufacturercommunications).",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns a single child seat with the specified ID",
        "schema": {
          "$ref": "#/definitions/ChildseatWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-equipment": {
    "operationId": "get-equipment",
    "method": "GET",
    "path": "/equipment",
    "summary": "",
    "tags": [
      "equipment"
    ],
    "parameters": [
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (complaints, recalls, investigations, manufacturerCommunications, none, all), defaults to 'all'.",
        "type": "string"
      },
      {
        "name": "brand",
        "in": "query",
        "required": false,
        "description": "brand of equipment",
        "type": "string"
      },
      {
        "name": "modelName",
        "in": "query",
        "required": false,
        "description": "model of the equipment",
        "type": "string"
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": "order",
        "in": "query",
        "required": false,
        "description": "order in which to sort",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records set to return for pagination.",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns zero or more equipment",
        "schema": {
          "items": {
            "$ref": "#/definitions/EquipmentWrapped"
          },
          "title": "ArrayOfEquipment",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-equipment-brands": {
    "operationId": "get-equipment-brands",
    "method": "GET",
    "path": "/equipment/brands",
    "summary": "",
    "tags": [
      "equipment"
    ],
    "parameters": [
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return. Use '-1' to get all records.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns all available equipment brands",
        "schema": {}
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-equipment-bySearch": {
    "operationId": "get-equipment-bySearch",
    "method": "GET",
    "path": "/equipment/bySearch",
    "summary": "",
    "tags": [
      "equipment"
    ],
    "parameters": [
      {
        "name": "query",
        "in": "query",
        "required": true,
        "description": "returns zero or more tires based on search query",
        "type": "string"
      },
      {
        "name": null,
        "in": null,
        "required": false,
        "description": "",
        "type": ""
      },
      {
        "name": "order",
        "in": "query",
        "required": false,
        "description": "order in which to sort",
        "type": "string"
      },
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (complaints, recalls, investigations, manufacturerCommunications, none, all), defaults to 'all'.",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return, upper bound: 50.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Fuzzy search for a equipment based on manufacturer and mode",
        "schema": {
          "$ref": "#/definitions/EquipmentWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-equipment-{id}": {
    "operationId": "get-equipment-{id}",
    "method": "GET",
    "path": "/equipment/{id}",
    "summary": "",
    "tags": [
      "equipment"
    ],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "ID of the equipmentDetails",
        "type": "integer"
      },
      {
        "name": "data",
        "in": "query",
        "required": false,
        "description": "A comma separated list of data to return (complaints, recalls, investigations, manufacturerCommunications, none, all), defaults to 'all'.",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns a single equipmentDetails with the specified ID",
        "schema": {
          "$ref": "#/definitions/EquipmentWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-ewr-damages": {
    "operationId": "get-ewr-damages",
    "method": "GET",
    "path": "/ewr/damages",
    "summary": "",
    "tags": [
      "ewr"
    ],
    "parameters": [
      {
        "name": "year",
        "in": "query",
        "required": true,
        "description": "The year of the reporting period",
        "type": "integer"
      },
      {
        "name": "quarter",
        "in": "query",
        "required": true,
        "description": "The quarter of the reporting period",
        "type": "integer"
      },
      {
        "name": "reportCategory",
        "in": "query",
        "required": true,
        "description": "The category of the property damage reports",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "The list of property damage reports",
        "schema": {
          "items": {
            "$ref": "#/definitions/EWRPropertyDamageWrapped"
          },
          "title": "ArrayOfEWRPropertyDamages",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-ewr-injuries": {
    "operationId": "get-ewr-injuries",
    "method": "GET",
    "path": "/ewr/injuries",
    "summary": "",
    "tags": [
      "ewr"
    ],
    "parameters": [
      {
        "name": "year",
        "in": "query",
        "required": true,
        "description": "The year of the reporting period",
        "type": "integer"
      },
      {
        "name": "quarter",
        "in": "query",
        "required": true,
        "description": "The quarter of the reporting period",
        "type": "integer"
      },
      {
        "name": "reportCategory",
        "in": "query",
        "required": true,
        "description": "The category of the injury reports",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "The list of injuries for the given report period and category",
        "schema": {
          "items": {
            "$ref": "#/definitions/EWRInjuryWrapped"
          },
          "title": "ArrayOfEWRInjuries",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-ewr-manufacturers": {
    "operationId": "get-ewr-manufacturers",
    "method": "GET",
    "path": "/ewr/manufacturers",
    "summary": "",
    "tags": [
      "ewr"
    ],
    "parameters": [],
    "responses": {
      "200": {
        "description": "The list of EWR manufacturers",
        "schema": {
          "$ref": "#/definitions/EWRManufacturersWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-ewr-manufacturers-{id}": {
    "operationId": "get-ewr-manufacturers-{id}",
    "method": "GET",
    "path": "/ewr/manufacturers/{id}",
    "summary": "",
    "tags": [
      "ewr"
    ],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "ID of manufacturer",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Details for a specific manufacturer",
        "schema": {
          "$ref": "#/definitions/EWRManufacturerDetailWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-ewr-productions": {
    "operationId": "get-ewr-productions",
    "method": "GET",
    "path": "/ewr/productions",
    "summary": "",
    "tags": [
      "ewr"
    ],
    "parameters": [
      {
        "name": "year",
        "in": "query",
        "required": true,
        "description": "The year of the reporting period",
        "type": "integer"
      },
      {
        "name": "quarter",
        "in": "query",
        "required": true,
        "description": "The quarter of the reporting period",
        "type": "integer"
      },
      {
        "name": "reportCategory",
        "in": "query",
        "required": true,
        "description": "The category of the light vehicle production reports",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "The list of light vehicle productions",
        "schema": {
          "items": {
            "$ref": "#/definitions/EWRProductionWrapped"
          },
          "title": "ArrayOfEWRProductions",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-foreignCampaigns": {
    "operationId": "get-foreignCampaigns",
    "method": "GET",
    "path": "/foreignCampaigns",
    "summary": "",
    "tags": [
      "foreignCampaigns"
    ],
    "parameters": [
      {
        "name": "manufacturer",
        "in": "query",
        "required": false,
        "description": "manufacturer associated with the foreign campaign",
        "type": "string"
      },
      {
        "name": "dateStart",
        "in": "query",
        "required": false,
        "description": "The date to restrict the search to. Format: yyyy-MM-dd",
        "type": "integer"
      },
      {
        "name": "dateEnd",
        "in": "query",
        "required": false,
        "description": "The date to restrict the search to. Format: yyyy-MM-dd",
        "type": "integer"
      },
      {
        "name": "order",
        "in": "query",
        "required": false,
        "description": "order in which to sort",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records set to return for pagination.",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns zero or more Foreign Campaigns",
        "schema": {
          "items": {
            "$ref": "#/definitions/ForeignCampaignWrapped"
          },
          "title": "ArrayOfForeignCampaign",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-foreignCampaigns-manufacturers": {
    "operationId": "get-foreignCampaigns-manufacturers",
    "method": "GET",
    "path": "/foreignCampaigns/manufacturers",
    "summary": "",
    "tags": [
      "foreignCampaigns"
    ],
    "parameters": [
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return. Use '-1' to get all records.",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns all available Foreign Campaign manufacturers",
        "schema": {
          "$ref": "#/definitions/ApiResponse"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-foreignCampaigns-{id}": {
    "operationId": "get-foreignCampaigns-{id}",
    "method": "GET",
    "path": "/foreignCampaigns/{id}",
    "summary": "",
    "tags": [
      "foreignCampaigns"
    ],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "ID of the Foreign Campaign",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Returns a single Foreign Campaign with the specified ID",
        "schema": {
          "$ref": "#/definitions/ForeignCampaignWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-safetyIssues": {
    "operationId": "get-safetyIssues",
    "method": "GET",
    "path": "/safetyIssues",
    "summary": "",
    "tags": [
      "safetyIssues"
    ],
    "parameters": [
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records set to return for pagination.",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "The list of safety issues",
        "schema": {
          "items": {
            "$ref": "#/definitions/SafetyIssue"
          },
          "title": "ArrayOfSafetyIssues",
          "type": "array"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-safetyIssues-byDate": {
    "operationId": "get-safetyIssues-byDate",
    "method": "GET",
    "path": "/safetyIssues/byDate",
    "summary": "",
    "tags": [
      "safetyIssues"
    ],
    "parameters": [
      {
        "name": "dateStart",
        "in": "query",
        "required": false,
        "description": "The start date to look up safetyIssues by.",
        "type": "string"
      },
      {
        "name": "dateEnd",
        "in": "query",
        "required": false,
        "description": "The end date to look up safetyIssues by.",
        "type": "string"
      },
      {
        "name": "issueType",
        "in": "query",
        "required": false,
        "description": "The specified issue type only: 'recall', 'investigation'.(defaults to recall)",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "Paginated list of SafetyIssues from within the specified date range.",
        "schema": {
          "$ref": "#/definitions/SafetyIssueAggregateWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-safetyIssues-byKeywords": {
    "operationId": "get-safetyIssues-byKeywords",
    "method": "GET",
    "path": "/safetyIssues/byKeywords",
    "summary": "",
    "tags": [
      "safetyIssues"
    ],
    "parameters": [
      {
        "name": "keywords",
        "in": "query",
        "required": true,
        "description": "The keyword[s] to search descriptions for (Only applicable to 'complaint' type). Natural language (words, spaces) is allowed.",
        "type": "string"
      },
      {
        "name": "allKeywords",
        "in": "query",
        "required": false,
        "description": "match must have all keywords. true or false. defaults to true",
        "type": "boolean"
      },
      {
        "name": "productType",
        "in": "query",
        "required": false,
        "description": "Valid inputs: [vehicle], [childSeat], [tireDetails], [equipment] without brackets. Choose which product type to limit the search to.",
        "type": "string"
      },
      {
        "name": "productYearStart",
        "in": "query",
        "required": false,
        "description": "Find only products made in the specified year or later",
        "type": "integer"
      },
      {
        "name": "productYearEnd",
        "in": "query",
        "required": false,
        "description": "Find only products made in the specified year or before",
        "type": "integer"
      },
      {
        "name": "productMake",
        "in": "query",
        "required": false,
        "description": "Restrict query to the specified make only",
        "type": "string"
      },
      {
        "name": "productModel",
        "in": "query",
        "required": false,
        "description": "Restrict query to the specified model only",
        "type": "string"
      },
      {
        "name": "issueType",
        "in": "query",
        "required": false,
        "description": "Valid inputs: [recall], [manufacturerCommunication], [complaint], [investigation] without brackets. Choose which issue type to limit the search to.",
        "type": "string"
      },
      {
        "name": "max",
        "in": "query",
        "required": false,
        "description": "The maximum number of records to return",
        "type": "integer"
      },
      {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "The offset of the records listing (for pagination).",
        "type": "integer"
      }
    ],
    "responses": {
      "200": {
        "description": "A list of issues containing the key word[s] in their descriptions.",
        "schema": {
          "$ref": "#/definitions/SafetyIssueAggregateWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-safetyIssues-byNhtsaId": {
    "operationId": "get-safetyIssues-byNhtsaId",
    "method": "GET",
    "path": "/safetyIssues/byNhtsaId",
    "summary": "",
    "tags": [
      "safetyIssues"
    ],
    "parameters": [
      {
        "name": "nhtsaId",
        "in": "query",
        "required": true,
        "description": "The nhtsa id to search for.",
        "type": "string"
      },
      {
        "name": "filter",
        "in": "query",
        "required": false,
        "description": "Filter the response by the specified field. Valid inputs: [issueType]",
        "type": "string"
      },
      {
        "name": "filterValue",
        "in": "query",
        "required": false,
        "description": "The value to use as a filter. Valid inputs: [recalls,complaints,investigations,manufacturerCommunications]",
        "type": "string"
      }
    ],
    "responses": {
      "200": {
        "description": "List of SafetyIssues identified by the specified nhtsaId.",
        "schema": {
          "$ref": "#/definitions/SafetyIssueAggregateWrapped"
        }
      },
      "400": {
        "description": "Invalid Request",
        "schema": {}
      },
      "500": {
        "description": "Internal Server Error",
        "schema": {}
      }
    }
  },
  "get-tires": {
    "

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dot/refs/heads/main/examples/nhtsa-datasets-api-examples.json