openapi: 3.0.0 info: version: 1.10.20 title: Car Account Years API description: 'Welcome to [CarAPIs vehicle API](https://carapi.app) documentation. The developer friendly Car API. Start developing with your vehicle API today — no fees, no signup. CarAPIs free vehicle data-set requires no account. Only pay when you''re ready to go live. The free data-set is limited to 2015-2020 vehicles. To access the full data-set you may [signup here](https://carapi.app/register) and then select a subscription plan. **Additional Documentation** For additional documentation please review [https://carapi.app/docs](https://carapi.app/docs). **SDKs** PHP SDK: [https://github.com/car-api-team/carapi-php-sdk](https://github.com/car-api-team/carapi-php-sdk) **Release Updates** Check release history here: [https://github.com/car-api-team/docs/releases](https://github.com/car-api-team/docs/releases) ' servers: - url: https://carapi.app tags: - name: Years paths: /api/years: get: operationId: years:index:get summary: Car API Get Years List description: 'For complex queries you may use the json field to send an array of URL encoded JSON conditions, example: `[{"field": "make", "op": "in", "val": ["Scion", "Tesla"]}]` Allowed operators are: `>`, `<`, `>=`, `<=`, `in`, `not in`, `like`, `not like`, `is null` and `not null`. Allowed search fields are: `year`, `make`, `model`, `trim`, `make_id`, and `make_model_id`.' tags: - Years parameters: - in: query name: year required: false schema: type: string description: Value - in: query name: make required: false schema: type: string description: Like - in: query name: model required: false schema: type: string description: Like - in: query name: trim required: false schema: type: string description: Like - in: query name: make_model_id required: false schema: type: string description: Value - in: query name: make_id required: false schema: type: string description: Value - in: query name: json required: false schema: type: string description: JsonSearchFilter responses: '200': description: '' content: application/json: schema: allOf: - $ref: '#/components/schemas/Year' '400': description: BadRequestException content: application/json: schema: title: BadRequestException properties: exception: example: BadRequestException type: string code: example: 400 type: string url: example: /url/path type: string message: example: The request contains invalid data. The returned error message should indicate the issue. type: string '405': description: MethodNotAllowedException content: application/json: schema: title: MethodNotAllowedException properties: exception: example: MethodNotAllowedException type: string code: example: 405 type: string url: example: /url/path type: string message: example: The HTTP method used to request this resource is not valid. For example, using an HTTP POST when the endpoint only accepts HTTP GET. type: string '503': description: ServiceUnavailableException content: application/json: schema: title: ServiceUnavailableException properties: exception: example: ServiceUnavailableException type: string code: example: 503 type: string url: example: /url/path type: string message: example: The server is unavailable, typically only encountered during scheduled maintenance. type: string security: - bearerAuth: [] components: schemas: Year: items: type: integer example: - 2022 - 2021 - 2020 type: array securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT x-swagger-bake: components: parameters: paginatorPage: name: page in: query required: false schema: type: integer paginatorLimit: name: limit in: query required: false schema: type: integer paginatorSort: name: sort in: query required: false schema: type: string paginatorDirection: name: direction in: query required: false schema: type: string enum: - asc - desc schemas: HalJson-Item: type: object properties: links: type: object properties: self: type: object properties: href: type: string format: url example: /entity/:id HalJson-Collection: type: object properties: links: type: object properties: self: type: object properties: href: type: string format: url example: /collection next: type: object properties: href: type: string format: url example: /collection?page=:number prev: type: object properties: href: type: string format: url example: /collection?page=:number first: type: object properties: href: type: string format: url example: /collection?page=:number properties: href: type: string format: url example: /collection?page=:number last: type: object properties: href: type: string format: url example: /collection?page=:number JsonLd-Item: type: object properties: '@id': type: string format: url example: /entity/:id '@type': type: string format: url example: https://schema.org/Thing '@context': type: string format: url example: /context/Entity JsonLd-Collection: type: object properties: '@id': type: string format: url example: /entity/:id '@type': type: string format: url example: https://schema.org/Thing '@context': type: string format: url example: /context/Entity view: type: object properties: '@id': type: string format: url example: /index '@type': type: string example: PartialCollectionView next: type: string format: url example: /index?page=:number prev: type: string format: url example: /index?page=:number first: type: string format: url example: /index last: type: string format: url example: /index?page=:number Generic-Collection: properties: collection: properties: url: example: /collection type: string format: url count: example: 50 type: integer pages: example: 20 type: integer total: example: 200 type: integer next: example: /collection?page=:number type: string format: url prev: example: /collection?page=:number type: string format: url first: example: /collection?page=:number type: string format: url last: example: /collection?page=:number type: string format: url type: object type: object x-data-element: data