{
  "openapi": "3.1.0",
  "info": {
    "title": "CarCheckTools Automotive Intelligence & VIN REST API",
    "version": "1.1.0",
    "description": "Cloudflare Edge-powered high performance automotive REST API for ISO 3779 VIN decoding, official NHTSA safety recalls, and SAE OBD-II DTC diagnostic trouble codes.",
    "contact": {
      "name": "CarCheckTools Engineering",
      "url": "https://carchecktools.com/developers",
      "email": "contact@carchecktools.com"
    }
  },
  "servers": [
    {
      "url": "https://carchecktools.com",
      "description": "Production Global Edge Network"
    }
  ],
  "paths": {
    "/api/v1/decode-vin": {
      "get": {
        "summary": "Decode 17-Digit Vehicle Identification Number (VIN)",
        "parameters": [
          {
            "name": "vin",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Decoded vehicle specs with ISO 3779 checksum status and NHTSA VPIC data"
          }
        }
      },
      "post": {
        "summary": "Decode 17-Digit Vehicle Identification Number (VIN) via JSON Body",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "vin": {
                    "type": "string",
                    "example": "5YJSA1DG9DFP14705"
                  }
                },
                "required": [
                  "vin"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Decoded vehicle specs with ISO 3779 checksum status and NHTSA VPIC data"
          }
        }
      }
    },
    "/api/v1/recalls": {
      "get": {
        "summary": "Query Official NHTSA Vehicle Safety Recalls",
        "parameters": [
          {
            "name": "make",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Official safety recall campaigns and free remedy instructions"
          }
        }
      },
      "post": {
        "summary": "Query Official NHTSA Vehicle Safety Recalls via JSON Body",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "make": {
                    "type": "string",
                    "example": "tesla"
                  },
                  "model": {
                    "type": "string",
                    "example": "model s"
                  },
                  "year": {
                    "type": "integer",
                    "example": 2013
                  }
                },
                "required": [
                  "make"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Official safety recall campaigns and free remedy instructions"
          }
        }
      }
    },
    "/api/v1/obd2": {
      "get": {
        "summary": "SAE OBD-II Diagnostic Trouble Code (DTC) Lookup",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Diagnostic trouble code description, causes, and repair costs"
          }
        }
      }
    }
  }
}