{
  "openapi": "3.1.0",
  "info": {
    "title": "VIN Decoder API",
    "version": "1.0.0",
    "description": "Decode any 17-character VIN into make, model, year, engine, body and plant details.\n\nDesigned for automotive industry professionals, insurance companies, dealerships, and individual car enthusiasts, our API delivers detailed, accurate vehicle specifications and history, enhancing transparency and trust in vehicle transactions and ownership. Whether verifying vehicle details, assessing value, or curating vehicle listings.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/vin-decoder.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/vin-decoder"
  },
  "servers": [
    {
      "url": "https://vin-decoder.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Data",
      "description": "VIN Decoder API belongs to the Data category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/decode": {
      "get": {
        "operationId": "decodeVin",
        "summary": "Decode VIN",
        "description": "Decode VIN endpoint of the VIN Decoder API. Costs 25 tokens per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vin-decoder/decode-vin"
        },
        "parameters": [
          {
            "name": "vin",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "5YJ3E1EA6PF384836"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "vin": "5YJ3E1EA6PF384836",
                  "manufacturedBy": "TESLA, INC.",
                  "model": "Model 3",
                  "year": "2023",
                  "vehicleType": "PASSENGER CAR",
                  "bodyClass": "Sedan/Saloon",
                  "primaryFuelType": "Electric",
                  "plantCountry": "UNITED STATES (USA)",
                  "plantState": "CALIFORNIA",
                  "errorText": "0 - VIN decoded clean. Check Digit (9th position) is correct"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 25 tokens per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}