VINaudit Specifications API

The Specifications API from VINaudit — 1 operation(s) for specifications.

Operations 1

GET /specifications Get Vehicle Specifications #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/vinaudit-specifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

vinaudit-specifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: VINaudit Vehicle Specifications API
  description: Retrieve standardized vehicle specifications by VIN or year/make/model/trim including engine details, transmission, fuel economy, dimensions, colors, equipment, NHTSA recalls, warranties, and vehicle photos. Supports lookup by VIN, vehicle ID, or year/make/model/trim combination.
  version: '3.0'
  contact:
    name: VINaudit Support
    url: https://www.vinaudit.com/vehicle-data-api
  license:
    name: Commercial
    url: https://www.vinaudit.com/vehicle-specifications-api
servers:
- url: https://specifications.vinaudit.com/v3
  description: VINaudit Vehicle Specifications API v3
tags:
- name: Specifications
paths:
  /specifications:
    get:
      operationId: getVehicleSpecifications
      summary: Get Vehicle Specifications
      description: 'Retrieve standardized vehicle specifications. Supports three lookup methods: by VIN, by vehicle ID string, or by year/make/model/trim (YMMT). Use the include parameter to filter which data sections are returned.'
      parameters:
      - name: key
        in: query
        required: true
        description: API authentication key
        schema:
          type: string
          example: YOUR_API_KEY_HERE
      - name: vin
        in: query
        required: false
        description: 17-character Vehicle Identification Number. Required if not providing id or YMMT parameters.
        schema:
          type: string
          example: 1NXBR32E85Z505904
      - name: id
        in: query
        required: false
        description: Vehicle ID string in year_make_model_trim format. Required if not providing vin or YMMT parameters.
        schema:
          type: string
          example: 2004_toyota_corolla_ce
      - name: year
        in: query
        required: false
        description: Vehicle model year. Required for YMMT lookup.
        schema:
          type: integer
          example: 2004
      - name: make
        in: query
        required: false
        description: Vehicle make (lowercase). Required for YMMT lookup.
        schema:
          type: string
          example: toyota
      - name: model
        in: query
        required: false
        description: Vehicle model (lowercase). Required for YMMT lookup.
        schema:
          type: string
          example: corolla
      - name: trim
        in: query
        required: false
        description: Vehicle trim level (lowercase). Optional for YMMT lookup.
        schema:
          type: string
          example: ce
      - name: include
        in: query
        required: false
        description: Comma-separated list of data sections to include in response. If omitted, all sections are returned.
        schema:
          type: string
          example: selections,attributes,equipment,colors,recalls,warranties,photos
      - name: format
        in: query
        required: false
        description: Response format
        schema:
          type: string
          enum:
          - json
          - xml
          default: json
      responses:
        '200':
          description: Vehicle specifications response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpecificationsResponse'
              example:
                input:
                  key: YOUR_API_KEY_HERE
                  year: '2005'
                  make: toyota
                  model: corolla
                  trim: ce
                  format: json
                selections:
                  trims:
                  - id: 2005_toyota_corolla_ce
                    name: CE
                    selected: 1
                    styles: []
                attributes:
                  year: '2005'
                  make: Toyota
                  model: Corolla
                  trim: CE
                  type: Car
                  engine: 1.8-L L-4 DOHC 16V
                  fuel_type: Regular Unleaded
                success: true
                error: ''
      tags:
      - Specifications
components:
  schemas:
    WarrantyItem:
      type: object
      description: A vehicle warranty
      properties:
        type:
          type: string
          description: Warranty type (basic, powertrain, corrosion, etc.)
        miles:
          type: integer
          description: Warranty mileage limit
        months:
          type: integer
          description: Warranty time limit in months
    SpecificationsResponse:
      type: object
      description: Vehicle specifications API response
      properties:
        input:
          type: object
          description: Input parameters echoed back
        selections:
          type: object
          description: Available trim and style selections
          properties:
            trims:
              type: array
              items:
                $ref: '#/components/schemas/TrimSelection'
        attributes:
          $ref: '#/components/schemas/VehicleSpecAttributes'
        colors:
          type: array
          description: Available color options
          items:
            type: object
        equipment:
          type: array
          description: Equipment items with availability status
          items:
            type: object
        recalls:
          type: array
          description: NHTSA recall records
          items:
            $ref: '#/components/schemas/RecallItem'
        warranties:
          type: array
          description: Manufacturer warranty details
          items:
            $ref: '#/components/schemas/WarrantyItem'
        photos:
          type: array
          description: Vehicle image URLs
          items:
            type: string
            format: uri
        success:
          type: boolean
          description: Whether specifications data was found
        error:
          type: string
          description: Error code or empty string
          enum:
          - ''
          - invalid_inputs
          - invalid_vin
          - no_data
          - api_not_enabled
    VehicleSpecAttributes:
      type: object
      description: Standardized vehicle specification attributes
      properties:
        year:
          type: string
          description: Model year
          example: '2005'
        make:
          type: string
          description: Vehicle make
          example: Toyota
        model:
          type: string
          description: Vehicle model
          example: Corolla
        trim:
          type: string
          description: Trim level
          example: CE
        style:
          type: string
          description: Body style
        type:
          type: string
          description: Vehicle type classification
          example: Car
        size:
          type: string
          description: Vehicle size category
        doors:
          type: integer
          description: Number of doors
        fuel_type:
          type: string
          description: Fuel type
          example: Regular Unleaded
        mpg_city:
          type: number
          description: City fuel economy in miles per gallon
        mpg_highway:
          type: number
          description: Highway fuel economy in miles per gallon
        engine:
          type: string
          description: Engine specification string
          example: 1.8-L L-4 DOHC 16V
        transmission:
          type: string
          description: Transmission type
        drivetrain:
          type: string
          description: Drivetrain type (FWD, RWD, AWD, 4WD)
        weight:
          type: number
          description: Curb weight in pounds
        msrp:
          type: number
          description: Manufacturer suggested retail price
    TrimSelection:
      type: object
      description: A trim level selection entry
      properties:
        id:
          type: string
          description: Trim identifier
          example: 2005_toyota_corolla_ce
        name:
          type: string
          description: Trim name
          example: CE
        selected:
          type: integer
          description: Whether this trim is selected (1=yes, 0=no)
        styles:
          type: array
          description: Body style variations for this trim
          items:
            type: object
    RecallItem:
      type: object
      description: An NHTSA recall record
      properties:
        id:
          type: string
          description: Recall identifier
        date:
          type: string
          format: date
          description: Recall date
        component:
          type: string
          description: Affected vehicle component
        description:
          type: string
          description: Recall description
        remedy:
          type: string
          description: Recall remedy