{
  "openapi": "3.1.0",
  "info": {
    "title": "TheVehicleDB API v2",
    "version": "2.0.0",
    "description": "JSON access to vehicle brands, models, factories and countries. The public test key 3 returns at most one record per request. No pagination parameter is supported; broader endpoints are capped, not guaranteed complete exports. IDs and years in responses are strings. Supply your key in the X-API-KEY header. Missing or invalid keys return HTTP 400."
  },
  "servers": [
    {
      "url": "https://www.thevehicledb.com/api/v2/json"
    }
  ],
  "tags": [
    {
      "name": "Search"
    },
    {
      "name": "Lookup"
    },
    {
      "name": "List"
    },
    {
      "name": "All"
    }
  ],
  "paths": {
    "/search/brand/{query}": {
      "get": {
        "operationId": "v2SearchBrand",
        "tags": [
          "Search"
        ],
        "summary": "Search brand",
        "description": "Returns at most 25 records with a premium key and at most one with public key 3. Prefix search of the primary and alternate name. Underscores are replaced with spaces. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchBrandResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "search": [
                        {
                          "idBrand": "4164",
                          "strBrand": "AC",
                          "strBrandAlternate": null,
                          "strCountry": "United Kingdom",
                          "intFormedYear": "1901",
                          "strBadge": "https://www.thevehicledb.com/images/media/brand/badge/7a779q1756112511.png",
                          "strLogo": null,
                          "strPoster": "https://www.thevehicledb.com/images/media/brand/poster/ems6b51756154578.jpg"
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "query",
            "in": "path",
            "required": true,
            "description": "Name prefix. Use underscores for spaces.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "ac"
          }
        ]
      }
    },
    "/lookup/brand/{id}": {
      "get": {
        "operationId": "v2LookupBrand",
        "tags": [
          "Lookup"
        ],
        "summary": "Lookup brand",
        "description": "Returns at most 1 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\". Invalid IDs return a Message object with HTTP 200.",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LookupBrandResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "lookup": [
                        {
                          "idBrand": "4164",
                          "strBrand": "AC",
                          "strBrandAlternate": null,
                          "strCountry": "United Kingdom",
                          "strDescriptionEN": "AC Cars was established in 1901, and is the UK’s oldest active vehicle manufacturer. It combines rich heritage with cutting-edge innovation. Dedicated to crafting exclusive sports cars that honour our storied past, we deliver an unrivalled service to clients worldwide.",
                          "intFormedYear": "1901",
                          "strBadge": "https://www.thevehicledb.com/images/media/brand/badge/7a779q1756112511.png",
                          "strLogo": null,
                          "strPoster": "https://www.thevehicledb.com/images/media/brand/poster/ems6b51756154578.jpg",
                          "strBanner": null,
                          "strFanart1": null,
                          "strFanart2": null,
                          "strFanart3": null,
                          "strFanart4": null,
                          "strFeatured": "0",
                          "strWebsite": null,
                          "strFacebook": null,
                          "strInstagram": null,
                          "strTwitter": null,
                          "strYoutube": null,
                          "strLocked": "Unlocked"
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Primary entity ID.",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "example": 4164
          }
        ]
      }
    },
    "/search/model/{query}": {
      "get": {
        "operationId": "v2SearchModel",
        "tags": [
          "Search"
        ],
        "summary": "Search model",
        "description": "Returns at most 25 records with a premium key and at most one with public key 3. Prefix search of the primary and alternate name. Underscores are replaced with spaces. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchModelResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "search": [
                        {
                          "idModel": "12",
                          "idBrand": "4164",
                          "idFactory": null,
                          "strBrand": "AC",
                          "strModel": "Cobra",
                          "strModelAlternate": "",
                          "strClassification": "Sports car",
                          "intFirstYear": "1962",
                          "intLastYear": "1990",
                          "strCountry": "United Kingdom",
                          "strThumb": "https://www.thevehicledb.com/images/media/model/thumb/tzpxlk1756114126.jpg",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "query",
            "in": "path",
            "required": true,
            "description": "Name prefix. Use underscores for spaces.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "cobra"
          }
        ]
      }
    },
    "/lookup/model/{id}": {
      "get": {
        "operationId": "v2LookupModel",
        "tags": [
          "Lookup"
        ],
        "summary": "Lookup model",
        "description": "Returns at most 1 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\". Invalid IDs return a Message object with HTTP 200.",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LookupModelResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "lookup": [
                        {
                          "idModel": "12",
                          "idBrand": "4164",
                          "idFactory": null,
                          "strBrand": "AC",
                          "strModel": "Cobra",
                          "strModelAlternate": "",
                          "strDescriptionEN": "The AC Cobra, sold in the United States as the Shelby Cobra and AC Shelby Cobra, is a sports car manufactured by British company AC Cars, with a Ford V8 engine. It was produced intermittently in both the United Kingdom and later the United States since 1962.\r\n\r\nHistory and development\r\nLike many British manufacturers, AC Cars had been using the Bristol straight-6 engine in its small-volume production, including its AC Ace two-seater roadster. The Ace had a hand-built body with a steel tube frame, and aluminium body panels that were made using English wheeling machines. The engine was a pre-World War II design by BMW which by the 1960s was considered dated. In 1961 Bristol decided to cease production of its engine.\r\n\r\nIn September 1961, Ford provided Shelby with two engines.",
                          "strPlatform": "-",
                          "strClassification": "Sports car",
                          "intFirstYear": "1962",
                          "intLastYear": "1990",
                          "strProductionYears": "1962-1968, 1983-1990",
                          "strClassificationUSA": "",
                          "strModelYearsUSA": "",
                          "strCountry": "United Kingdom",
                          "strColour1": "",
                          "strColour2": "",
                          "strColour3": "",
                          "strSoldEurope": "Specialty",
                          "strSoldUSA": "Specialty",
                          "strSoldIndia": "Specialty",
                          "strProducedUnits": "75+571+27 + 306 (to 1966)",
                          "strFactory": "",
                          "strNotes": "",
                          "strRender": null,
                          "strThumb": "https://www.thevehicledb.com/images/media/model/thumb/tzpxlk1756114126.jpg",
                          "strLogo": null,
                          "strBanner": null,
                          "strFanart1": null,
                          "strFanart2": null,
                          "strFanart3": null,
                          "strFanart4": null,
                          "strWebsite": "",
                          "strInstagram": "",
                          "strTwitter": "",
                          "strFacebook": "",
                          "strYoutube": "",
                          "intLoved": "1",
                          "strLocked": "Unlocked"
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Primary entity ID.",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "example": 12
          }
        ]
      }
    },
    "/search/factory/{query}": {
      "get": {
        "operationId": "v2SearchFactory",
        "tags": [
          "Search"
        ],
        "summary": "Search factory",
        "description": "Returns at most 25 records with a premium key and at most one with public key 3. Prefix search of the primary and alternate name. Underscores are replaced with spaces. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchFactoryResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "search": [
                        {
                          "idFactory": "1141",
                          "strFactory": "Cassino Plant",
                          "strFactoryAlternate": "",
                          "strCountry": "Italy",
                          "strLocation": "Frosinone, Italy",
                          "intFormedYear": "1972",
                          "strThumb": "https://www.thevehicledb.com/images/media/factory/thumb/mz5oz11761299926.jpg",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "query",
            "in": "path",
            "required": true,
            "description": "Name prefix. Use underscores for spaces.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "cassino"
          }
        ]
      }
    },
    "/lookup/factory/{id}": {
      "get": {
        "operationId": "v2LookupFactory",
        "tags": [
          "Lookup"
        ],
        "summary": "Lookup factory",
        "description": "Returns at most 1 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\". Invalid IDs return a Message object with HTTP 200.",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LookupFactoryResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "lookup": [
                        {
                          "idFactory": "1141",
                          "idDupe": null,
                          "strFactory": "Cassino Plant",
                          "strFactoryAlternate": "",
                          "strSport": null,
                          "strDescriptionEN": "The Cassino Assembly Plant is a car assembly plant owned by Stellantis. It is located in the town of Piedimonte San Germano, three kilometers from Cassino, in the province of Frosinone, Italy. The car assembly plant started in 1972 with the production of Fiat 126. Today, it has a total surface area of 2 million square meters, of which 400 thousand are covered. The plant currently employs around 4,300 people.\r\n\r\nOver seven million Fiat, Lancia and Alfa Romeo cars have rolled out over time. Models include the Fiat Tipo, Fiat Bravo/Brava, Fiat Tempra, Fiat Croma, Fiat Stilo, Lancia Delta, Alfa Romeo Giulietta, Alfa Romeo Giulia and Alfa Romeo Stelvio.\r\n\r\nHistory\r\nThe Cassino Assembly Plant was built in 1972 near Cassino to build the Fiat 126. The Fiat 126 was in production until 2000 and was the last Fiat to fit a rear engine. In 1974, the Fiat 131 was introduced which stayed in production until 1984.\r\n\r\nProduction of the Fiat Ritmo, a new Italian mid-size car, was kicked off six years after the plant was opened. Comau Robogate systems were installed in 1978 in the Fiat Rivalta plant and in Cassino. This highly automated system was designed to facilitate and speed up the tasks of workers in the Body Shop. The plant was now operating at full capacity. Production of a new car – the Fiat Regata – started in 1983.\r\n\r\nOver little more than ten years, the plant had become firmly established in the area and employed many locals. New models were introduced including the Fiat Tipo in 1988. The car had a fully galvanized body and the use of new materials forced to modernize the systems. The model would be a best-seller and up to one thousand cars would roll off the lines a day.\r\n\r\nProduction of the Tempra started one year later. The model came in three versions – sedan, wagon and van, named Marengo – and shared many components with the Tipo, such as the engines, the platform, the doors and the suspension. These models were replaced from 1995 to 1996 by a new family of cars: the Bravo and Brava, the Marea and the new Marengo van.\r\n\r\nThe production lines of the Bravo, Brava, and Marea were pulled down to make way for the assembly lines of the Stilo which started production in 2001. The factory underwent yet another major technological advance when the Robogate was retired and replaced by the Open Gate system, which offered more efficient and accurate side panel welding. The production rate of the plant increased and touched 250 thousand cars a year.",
                          "strArchitect": "",
                          "intCapacity": "0",
                          "strCost": "",
                          "strCountry": "Italy",
                          "strLocation": "Frosinone, Italy",
                          "strTimezone": null,
                          "intFormedYear": "1972",
                          "strFanart1": null,
                          "strFanart2": null,
                          "strFanart3": null,
                          "strFanart4": null,
                          "strThumb": "https://www.thevehicledb.com/images/media/factory/thumb/mz5oz11761299926.jpg",
                          "strLogo": null,
                          "strMap": null,
                          "strWebsite": "",
                          "strFacebook": "",
                          "strInstagram": "",
                          "strTwitter": "",
                          "strYoutube": "",
                          "strCreativeCommons": "NO",
                          "strLocked": "unlocked"
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Primary entity ID.",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "example": 1141
          }
        ]
      }
    },
    "/list/models/{value}": {
      "get": {
        "operationId": "v2ListModels",
        "tags": [
          "List"
        ],
        "summary": "List models by brand",
        "description": "Returns at most 1,000 records with a premium key and at most one with public key 3. Matches the brand ID; ordered by first year and model name. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListModelsResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "list": [
                        {
                          "idModel": "6",
                          "idBrand": "4164",
                          "idFactory": null,
                          "strBrand": "AC",
                          "strModel": "2-Litre",
                          "strClassification": "Large car",
                          "intFirstYear": "1947",
                          "intLastYear": "1958",
                          "strCountry": "United Kingdom",
                          "strThumb": null,
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "value",
            "in": "path",
            "required": true,
            "description": "Brand ID.",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "example": 4164
          }
        ]
      }
    },
    "/list/brands/{value}": {
      "get": {
        "operationId": "v2ListBrands",
        "tags": [
          "List"
        ],
        "summary": "List brands by country",
        "description": "Returns at most 1,000 records with a premium key and at most one with public key 3. Matches the country name; underscores are replaced with spaces. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListBrandsResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "list": [
                        {
                          "idBrand": "4164",
                          "strBrand": "AC",
                          "strBrandAlternate": null,
                          "strCountry": "United Kingdom",
                          "intFormedYear": "1901",
                          "strBadge": "https://www.thevehicledb.com/images/media/brand/badge/7a779q1756112511.png",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "value",
            "in": "path",
            "required": true,
            "description": "Country name. Use underscores for spaces.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "united_kingdom"
          }
        ]
      }
    },
    "/list/factories/{value}": {
      "get": {
        "operationId": "v2ListFactories",
        "tags": [
          "List"
        ],
        "summary": "List factories by brand",
        "description": "Returns at most 1,000 records with a premium key and at most one with public key 3. Finds distinct factories linked to a brand through its models. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListFactoriesResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "list": [
                        {
                          "idFactory": "1141",
                          "strFactory": "Cassino Plant",
                          "strFactoryAlternate": "",
                          "strCountry": "Italy",
                          "strLocation": "Frosinone, Italy",
                          "intFormedYear": "1972",
                          "strThumb": "https://www.thevehicledb.com/images/media/factory/thumb/mz5oz11761299926.jpg",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "value",
            "in": "path",
            "required": true,
            "description": "Brand ID.",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "example": 4171
          }
        ]
      }
    },
    "/all/countries": {
      "get": {
        "operationId": "v2AllCountries",
        "tags": [
          "All"
        ],
        "summary": "All countries",
        "description": "Returns at most 500 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AllCountriesResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "all": [
                        {
                          "idAPIfootball": null,
                          "code": "AF",
                          "name_en": "Afghanistan",
                          "name_fr": "Afghanistan",
                          "flag_url_16": "https://www.thesportsdb.com/images/icons/flags/shiny/16/Afghanistan.png",
                          "flag_url_32": "https://www.thesportsdb.com/images/icons/flags/shiny/32/Afghanistan.png",
                          "flag_url_64": "https://www.thesportsdb.com/images/icons/flags/shiny/64/Afghanistan.png"
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        }
      }
    },
    "/all/brands": {
      "get": {
        "operationId": "v2AllBrands",
        "tags": [
          "All"
        ],
        "summary": "All brands",
        "description": "Returns at most 3,000 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AllBrandsResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "all": [
                        {
                          "idBrand": "4164",
                          "strBrand": "AC",
                          "strBrandAlternate": null,
                          "strCountry": "United Kingdom",
                          "intFormedYear": "1901",
                          "strBadge": "https://www.thevehicledb.com/images/media/brand/badge/7a779q1756112511.png",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        }
      }
    },
    "/all/models": {
      "get": {
        "operationId": "v2AllModels",
        "tags": [
          "All"
        ],
        "summary": "All models",
        "description": "Returns at most 5,000 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AllModelsResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "all": [
                        {
                          "idModel": "6",
                          "idBrand": "4164",
                          "idFactory": null,
                          "strBrand": "AC",
                          "strModel": "2-Litre",
                          "strClassification": "Large car",
                          "intFirstYear": "1947",
                          "intLastYear": "1958",
                          "strCountry": "United Kingdom",
                          "strThumb": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        }
      }
    },
    "/all/factories": {
      "get": {
        "operationId": "v2AllFactories",
        "tags": [
          "All"
        ],
        "summary": "All factories",
        "description": "Returns at most 3,000 records with a premium key and at most one with public key 3. No matches return HTTP 200 with a Message object containing \"No data found\".",
        "responses": {
          "200": {
            "description": "Successful response, no matches, or an application-level validation message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AllFactoriesResponse"
                },
                "examples": {
                  "publicKey": {
                    "summary": "Example response using public test key 3",
                    "value": {
                      "all": [
                        {
                          "idFactory": "1141",
                          "strFactory": "Cassino Plant",
                          "strFactoryAlternate": "",
                          "strCountry": "Italy",
                          "strLocation": "Frosinone, Italy",
                          "intFormedYear": "1972",
                          "strThumb": "https://www.thevehicledb.com/images/media/factory/thumb/mz5oz11761299926.jpg",
                          "strLogo": null
                        }
                      ]
                    }
                  },
                  "noMatches": {
                    "summary": "No matching data",
                    "value": {
                      "Message": "No data found"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Request rate limit exceeded. Limits are enforced by the service infrastructure."
          },
          "400": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                },
                "example": {
                  "Message": "Missing API key in header, sign up at https://www.thevehicledb.com/pricing"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Brand": {
        "type": "object",
        "description": "Fields depend on the endpoint. Lookup returns full records; search and list endpoints return selected fields. Database values are serialized as strings or null, including IDs and years.",
        "properties": {
          "idBrand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strBrand": {
            "type": [
              "string",
              "null"
            ]
          },
          "strBrandAlternate": {
            "type": [
              "string",
              "null"
            ]
          },
          "strCountry": {
            "type": [
              "string",
              "null"
            ]
          },
          "intFormedYear": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strBadge": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "strLogo": {
            "type": [
              "string",
              "null"
            ]
          },
          "strPoster": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "strDescriptionEN": {
            "type": [
              "string",
              "null"
            ]
          },
          "strBanner": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart1": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart2": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart3": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart4": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFeatured": {
            "type": [
              "string",
              "null"
            ]
          },
          "strWebsite": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFacebook": {
            "type": [
              "string",
              "null"
            ]
          },
          "strInstagram": {
            "type": [
              "string",
              "null"
            ]
          },
          "strTwitter": {
            "type": [
              "string",
              "null"
            ]
          },
          "strYoutube": {
            "type": [
              "string",
              "null"
            ]
          },
          "strLocked": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true,
        "required": [
          "idBrand"
        ]
      },
      "Model": {
        "type": "object",
        "description": "Fields depend on the endpoint. Lookup returns full records; search and list endpoints return selected fields. Database values are serialized as strings or null, including IDs and years.",
        "properties": {
          "idModel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "idBrand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "idFactory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strBrand": {
            "type": [
              "string",
              "null"
            ]
          },
          "strModel": {
            "type": [
              "string",
              "null"
            ]
          },
          "strModelAlternate": {
            "type": [
              "string",
              "null"
            ]
          },
          "strClassification": {
            "type": [
              "string",
              "null"
            ]
          },
          "intFirstYear": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "intLastYear": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strCountry": {
            "type": [
              "string",
              "null"
            ]
          },
          "strThumb": {
            "type": [
              "string",
              "null"
            ]
          },
          "strLogo": {
            "type": [
              "string",
              "null"
            ]
          },
          "strDescriptionEN": {
            "type": [
              "string",
              "null"
            ]
          },
          "strPlatform": {
            "type": [
              "string",
              "null"
            ]
          },
          "strProductionYears": {
            "type": [
              "string",
              "null"
            ]
          },
          "strClassificationUSA": {
            "type": [
              "string",
              "null"
            ]
          },
          "strModelYearsUSA": {
            "type": [
              "string",
              "null"
            ]
          },
          "strColour1": {
            "type": [
              "string",
              "null"
            ]
          },
          "strColour2": {
            "type": [
              "string",
              "null"
            ]
          },
          "strColour3": {
            "type": [
              "string",
              "null"
            ]
          },
          "strSoldEurope": {
            "type": [
              "string",
              "null"
            ]
          },
          "strSoldUSA": {
            "type": [
              "string",
              "null"
            ]
          },
          "strSoldIndia": {
            "type": [
              "string",
              "null"
            ]
          },
          "strProducedUnits": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFactory": {
            "type": [
              "string",
              "null"
            ]
          },
          "strNotes": {
            "type": [
              "string",
              "null"
            ]
          },
          "strRender": {
            "type": [
              "string",
              "null"
            ]
          },
          "strBanner": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart1": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart2": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart3": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart4": {
            "type": [
              "string",
              "null"
            ]
          },
          "strWebsite": {
            "type": [
              "string",
              "null"
            ]
          },
          "strInstagram": {
            "type": [
              "string",
              "null"
            ]
          },
          "strTwitter": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFacebook": {
            "type": [
              "string",
              "null"
            ]
          },
          "strYoutube": {
            "type": [
              "string",
              "null"
            ]
          },
          "intLoved": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strLocked": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true,
        "required": [
          "idModel"
        ]
      },
      "Factory": {
        "type": "object",
        "description": "Fields depend on the endpoint. Lookup returns full records; search and list endpoints return selected fields. Database values are serialized as strings or null, including IDs and years.",
        "properties": {
          "idFactory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strFactory": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFactoryAlternate": {
            "type": [
              "string",
              "null"
            ]
          },
          "strCountry": {
            "type": [
              "string",
              "null"
            ]
          },
          "strLocation": {
            "type": [
              "string",
              "null"
            ]
          },
          "intFormedYear": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strThumb": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "strLogo": {
            "type": [
              "string",
              "null"
            ]
          },
          "idDupe": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strSport": {
            "type": [
              "string",
              "null"
            ]
          },
          "strDescriptionEN": {
            "type": [
              "string",
              "null"
            ]
          },
          "strArchitect": {
            "type": [
              "string",
              "null"
            ]
          },
          "intCapacity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          },
          "strCost": {
            "type": [
              "string",
              "null"
            ]
          },
          "strTimezone": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart1": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart2": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart3": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFanart4": {
            "type": [
              "string",
              "null"
            ]
          },
          "strMap": {
            "type": [
              "string",
              "null"
            ]
          },
          "strWebsite": {
            "type": [
              "string",
              "null"
            ]
          },
          "strFacebook": {
            "type": [
              "string",
              "null"
            ]
          },
          "strInstagram": {
            "type": [
              "string",
              "null"
            ]
          },
          "strTwitter": {
            "type": [
              "string",
              "null"
            ]
          },
          "strYoutube": {
            "type": [
              "string",
              "null"
            ]
          },
          "strCreativeCommons": {
            "type": [
              "string",
              "null"
            ]
          },
          "strLocked": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true,
        "required": [
          "idFactory"
        ]
      },
      "Country": {
        "type": "object",
        "description": "Fields depend on the endpoint. Lookup returns full records; search and list endpoints return selected fields. Database values are serialized as strings or null, including IDs and years.",
        "properties": {
          "code": {
            "type": [
              "string",
              "null"
            ]
          },
          "name_en": {
            "type": [
              "string",
              "null"
            ]
          },
          "name_fr": {
            "type": [
              "string",
              "null"
            ]
          },
          "flag_url_16": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "flag_url_32": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "flag_url_64": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork URL; may be null or an empty string when unavailable."
          },
          "idAPIfootball": {
            "type": [
              "string",
              "null"
            ],
            "description": "Numeric value returned as a JSON string; may be null or empty when unknown."
          }
        },
        "additionalProperties": true,
        "required": [
          "code"
        ]
      },
      "Message": {
        "type": "object",
        "required": [
          "Message"
        ],
        "properties": {
          "Message": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "SearchBrandResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "search"
            ],
            "properties": {
              "search": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Brand"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "LookupBrandResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "lookup"
            ],
            "properties": {
              "lookup": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Brand"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "SearchModelResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "search"
            ],
            "properties": {
              "search": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Model"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "LookupModelResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "lookup"
            ],
            "properties": {
              "lookup": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Model"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "SearchFactoryResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "search"
            ],
            "properties": {
              "search": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Factory"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "LookupFactoryResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "lookup"
            ],
            "properties": {
              "lookup": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Factory"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "ListModelsResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "list"
            ],
            "properties": {
              "list": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Model"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "ListBrandsResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "list"
            ],
            "properties": {
              "list": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Brand"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "ListFactoriesResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "list"
            ],
            "properties": {
              "list": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Factory"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "AllCountriesResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "all"
            ],
            "properties": {
              "all": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Country"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "AllBrandsResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "all"
            ],
            "properties": {
              "all": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Brand"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "AllModelsResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "all"
            ],
            "properties": {
              "all": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Model"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      },
      "AllFactoriesResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "all"
            ],
            "properties": {
              "all": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Factory"
                }
              }
            },
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/Message"
          }
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "description": "Use public test key 3, or your own premium key."
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}
