openapi: 3.0.0
info:
  title: 'AuctionsApi.com'
  contact:
    email: hit.hitm4n@yandex.com
  version: 1.0.0

servers:
  - url: 'https://auctionsapi.com/api/'

tags:
  - name: Main endpoints
  - name: Additional endpoints

paths:
  /cars:
    get:
      description: 'Default: 50. Maximum: 50 for Demo/Small; 1000 for Unlimited. Set per_page=1000 explicitly on Unlimited and use page for the next results. Each vehicle may contain lots[].seller_reserve. Seller reserve price, when available. Object with price (reserve amount) and updated_at (last reserve update timestamp, or null); seller_reserve is null when no reserve is available. This is not the current bid or a confirmed final sale price. Read it from the relevant lot. Example: {"price":8500,"updated_at":"2026-09-13T10:30:00.000000Z"}.'
      tags:
        - Main endpoints
      summary: get all cars
      operationId: 5c016f94af420eb75736c4c8d142203d
      parameters:
        - name: domain_id
          in: query
          description: "Source platform ID: 1=IAAI, 3=Copart, 12=Encar. Omit to use sources enabled for the key. Send one integer, not an array. Unsupported IDs return 400; sources outside your access return 401."
          required: false
          schema:
            type: integer
        - name: minutes
          in: query
          description: this parameter allows you to retrieve only those cars that have been updated in the last few minutes (max 4320 minutes)
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 4320
        - name: per_page
          in: query
          description: "Default: 50. Maximum: 50 for Demo/Small; 1000 for Unlimited. Set per_page=1000 explicitly on Unlimited and use page for the next results."
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 50
        - name: page
          in: query
          description: Optional page number, starting at 1 (default). Keep filters unchanged when requesting subsequent pages.
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: manufacturer_id
          in: query
          description: |
            Manufacturer ID(s) (number, comma-separated for multiple values, e.g. `16,88,...`).

            To get the ID, use the `/manufacturers` endpoint.
          required: false
          schema:
            type: string
        - name: model_id
          in: query
          description: Car model id, to get it use `/models` endpoint
          required: false
          schema:
            type: integer
        - name: generation_id
          in: query
          description: Car generation id, to get it use `/generations` endpoint
          required: false
          schema:
            type: integer
        - name: from_year
          in: query
          description: Filter from specific year
          required: false
          schema:
            type: integer
        - name: to_year
          in: query
          description: Filter to specific year
          required: false
          schema:
            type: integer
        - name: year
          in: query
          description: Filter with fixed year
          required: false
          schema:
            type: integer
        - name: vehicle_type
          in: query
          description: Vehicle type, automobile = 1, motorcycle = 2, atv = 5, watercraft = 12, jet_sky = 11, boat = 7, trailers = 3, mobile_home = 10, emergency_equipment = 13, industrial_equipment = 9, truck = 4, bus = 8
          required: false
          schema:
            type: integer
        - name: buy_now
          in: query
          description: Add buy_now=1 to get only cars with Buy Now price
          required: false
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: search_query
          in: query
          description: Search query, can be Vin code or Lot number
          required: false
          schema:
            type: string
        - name: status
          in: query
          description: One status ID. For multiple statuses use repeated status[] parameters, e.g. status[]=4&status[]=5. Do not combine status and status[].
          required: false
          schema:
            type: integer
        - name: status[]
          in: query
          required: false
          description: "Alternative to status: repeat this query parameter for multiple status IDs."
          schema:
            type: array
            items:
              type: integer
            minItems: 1
          style: form
          explode: true
        - name: vin
          in: query
          description: "VIN code to search, you can add _ in end or start of string, for example, search: NLM91_ to get all cars where VIN starts with NLM91"
          required: false
          schema:
            type: string
        - name: name
          in: query
          description: Search in Name of lot, for example Corvette will return all lots where Corvette is in title
          required: false
          schema:
            type: string
        - name: document_title
          in: query
          description: Search in Document title
          required: false
          schema:
            type: string
        - name: cylinders
          in: query
          description: Number of cylinders
          required: false
          schema:
            type: integer
        - name: engine_name
          in: query
          description: Search in name of engine
          required: false
          schema:
            type: string
        - name: body_type
          in: query
          description: "Filter by body type, possible values are: sedan = 1, wagon = 2, coupe = 3, pickup = 4, SUV = 5, cabrio = 6, VAN = 7, moto = 8, furgon = 9, combi = 10, hatchback = 11, roadster = 12, limousine = 13, truck = 14, bike = 15, sport bike = 16, roadster bike = 17, industrial = 18, bus = 19, liftback = 20, enduro bike = 21, hearse = 22, fire truck = 23, trailer = 24, tandem = 25, garbage = 26, sport_car = 27, other = 100"
          required: false
          schema:
            type: integer
        - name: color
          in: query
          description: "Filter by color, possible values are: silver = 1, purple = 2, orange = 3, green = 4, red = 5, gold = 6, charcoal = 7, brown = 8, grey = 9, turquoise = 10, blue = 11, bronze = 12, white = 13, cream = 14, black = 15, yellow = 16, beige = 17, pink = 18, two_colors = 100"
          required: false
          schema:
            type: integer
        - name: transmission
          in: query
          description: "Filter by transmission, possible values are: automatic = 1, manual = 2"
          required: false
          schema:
            type: integer
        - name: drive_wheel
          in: query
          description: "Filter by drive wheel, possible values are: rear = 1, front = 2, all = 3"
          required: false
          schema:
            type: integer
        - name: country
          in: query
          description: "Filter by country, for example use: US for United States, CA for Canada and KR for South Korea"
          required: false
          schema:
            type: string
        - name: state_code
          in: query
          description: "Filter by state code, for example use: CA for California or FL for Florida"
          required: false
          schema:
            type: string
        - name: fuel_type
          in: query
          description: "Filter by fuel type, possible values are: diesel = 1, electric = 2, hybrid = 3, gasoline = 4, gas = 5, flexible = 6, hydrogen = 7 Send a single integer; arrays are not supported."
          required: false
          schema:
            type: integer
        - name: condition
          in: query
          description: "Filter by condition, possible values are: run and drives = 0, for repair = 1, to be dismantled = 2, not run = 3, used = 4, unconfirmed = 5, engine starts = 6, enhanced = 7"
          required: false
          schema:
            type: integer
        - name: damage
          in: query
          description: Scalar text search, for example hail. Arrays and objects are not supported.
          required: false
          schema:
            type: string
        - name: prices_history
          in: query
          description: Add price history to response (set value 1 to get prices array)
          required: false
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: without_sale_date
          in: query
          description: If you add 1, it will return only the cars that do not have an auction date.
          required: false
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: sale_date_in_days
          in: query
          description: Lots where sale date is bigger than date of X days ago
          required: false
          schema:
            type: integer
        - name: sale_date_from
          in: query
          description: "Lots where sale date is bigger than value of this param, example: 2020-02-02T03:04:05 (this param is more important than sale_date_in_days)"
          required: false
          schema:
            type: string
        - name: sale_date_to
          in: query
          description: "Lots where sale date is less than value of this param, example: 2020-02-02T03:04:05"
          required: false
          schema:
            type: string
        - name: exclude_expired_auctions
          in: query
          description: "Send exclude_expired_auctions=1 to filter lots by 2 conditions: without sale date or with sale date in future"
          required: false
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: next_hours_auction
          in: query
          description: Lots with auction date within the next X hours
          required: false
          schema:
            type: integer
        - name: odometer_from_km
          in: query
          description: Odometer from (in kilometers)
          required: false
          schema:
            type: integer
        - name: odometer_to_km
          in: query
          description: Odometer to (in kilometers)
          required: false
          schema:
            type: integer
        - name: odometer_from_mi
          in: query
          description: Odometer from (in miles)
          required: false
          schema:
            type: integer
        - name: odometer_to_mi
          in: query
          description: Odometer to (in miles)
          required: false
          schema:
            type: integer
        - name: buy_now_price_from
          in: query
          description: "Buy now price: from"
          required: false
          schema:
            type: integer
        - name: buy_now_price_to
          in: query
          description: "Buy now price: to"
          required: false
          schema:
            type: integer
        - name: bid_price_from
          in: query
          description: "Current bid price: from"
          required: false
          schema:
            type: integer
        - name: bid_price_to
          in: query
          description: "Current bid price: to"
          required: false
          schema:
            type: integer
        - name: simple_paginate
          in: query
          description: Set 1 for simple pagination without totals, or 0 for totals. Set explicitly; account defaults may differ.
          required: false
          schema:
            type: integer
        - name: sortDirection
          in: query
          description: "Sort by vehicle ID: asc (default) or desc."
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
      responses:
        "200":
          description: A list of all cars
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Vehicle"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /manufacturers/{type}:
    get:
      tags:
        - Main endpoints
      summary: list all car brands
      operationId: c43da212517d44d769bb785ebe9bb2d2
      parameters:
        - name: type
          in: path
          description: Vehicle group; omit the segment for cars.
          required: true
          schema:
            type: string
            enum:
              - cars
              - motorcycles
              - all
            default: cars
          example: cars
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of manufacturers
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Manufacturer"
              example:
                data:
                  - id: 48
                    name: Ford
                    cars_qty: 93791
                    image: https://auctionsapi.com/images/brands/ford.svg
                    models_qty: 119
                    cars: true
                    motorcycles: false
                  - id: 140
                    name: Toyota
                    cars_qty: 93028
                    image: https://auctionsapi.com/images/brands/toyota.svg
                    models_qty: 180
                    cars: true
                    motorcycles: false
                  - id: 26
                    name: Chevrolet
                    cars_qty: 83914
                    image: https://auctionsapi.com/images/brands/chevrolet.svg
                    models_qty: 126
                    cars: true
                    motorcycles: false
                  - id: 56
                    name: Honda
                    cars_qty: 73667
                    image: https://auctionsapi.com/images/brands/honda.svg
                    models_qty: 90
                    cars: true
                    motorcycles: true
                  - id: 99
                    name: Nissan
                    cars_qty: 64180
                    image: https://auctionsapi.com/images/brands/nissan.svg
                    models_qty: 124
                    cars: true
                    motorcycles: false
                links:
                  first: https://auctionsapi.com/api/manufacturers/cars?page=1
                  last: https://auctionsapi.com/api/manufacturers/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/manufacturers/cars
                  per_page: 1000
                  to: 424
                  total: 424
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /models/{manufacturer_id}/{type}:
    get:
      tags:
        - Main endpoints
      summary: list all car models with filter by brand
      operationId: 866de850b4d4bbec2c160c39c8eee84a
      parameters:
        - name: manufacturer_id
          in: path
          required: true
          schema:
            type: integer
          example: "16"
        - name: type
          in: path
          description: Vehicle group; omit the segment for cars.
          required: true
          schema:
            type: string
            enum:
              - cars
              - motorcycles
              - all
            default: cars
          example: cars
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of car models
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Model"
              example:
                data:
                  - id: 93
                    name: 3er
                    cars_qty: 4746
                    manufacturer_id: 16
                    generations_qty: 7
                  - id: 94
                    name: 5er
                    cars_qty: 2569
                    manufacturer_id: 16
                    generations_qty: 8
                  - id: 1665
                    name: X5
                    cars_qty: 2307
                    manufacturer_id: 16
                    generations_qty: 4
                  - id: 1895
                    name: X3
                    cars_qty: 2207
                    manufacturer_id: 16
                    generations_qty: 3
                  - id: 2070
                    name: 4er
                    cars_qty: 1014
                    manufacturer_id: 16
                    generations_qty: 3
                links:
                  first: https://auctionsapi.com/api/models/16/cars?page=1
                  last: https://auctionsapi.com/api/models/16/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/models/16/cars
                  per_page: 500
                  to: 62
                  total: 62
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /generations/{model_id}/{type}:
    get:
      tags:
        - Main endpoints
      summary: list all car generations with filter by model
      operationId: 8d98d611b9e9909cbc4e8f641201744f
      parameters:
        - name: model_id
          in: path
          required: true
          schema:
            type: integer
          example: "94"
        - name: type
          in: path
          description: Vehicle group; omit the segment for cars.
          required: true
          schema:
            type: string
            enum:
              - cars
              - motorcycles
            default: cars
          example: cars
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of car generations
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Generation"
              example:
                data:
                  - id: 391
                    name: I (E12)
                    cars_qty: 0
                    from_year: 1972
                    to_year: 1981
                    manufacturer_id: 16
                    model_id: 94
                  - id: 393
                    name: II (E28)
                    cars_qty: 2
                    from_year: 1981
                    to_year: 1988
                    manufacturer_id: 16
                    model_id: 94
                  - id: 394
                    name: III (E34)
                    cars_qty: 11
                    from_year: 1987
                    to_year: 1996
                    manufacturer_id: 16
                    model_id: 94
                  - id: 395
                    name: IV (E39)
                    cars_qty: 54
                    from_year: 1995
                    to_year: 2004
                    manufacturer_id: 16
                    model_id: 94
                  - id: 397
                    name: V (E60/E61)
                    cars_qty: 190
                    from_year: 2002
                    to_year: 2010
                    manufacturer_id: 16
                    model_id: 94
                  - id: 399
                    name: VI (F10/F11/F07)
                    cars_qty: 951
                    from_year: 2009
                    to_year: 2017
                    manufacturer_id: 16
                    model_id: 94
                  - id: 5126
                    name: VII (G30/G31)
                    cars_qty: 714
                    from_year: 2016
                    to_year: 2023
                    manufacturer_id: 16
                    model_id: 94
                  - id: 7288
                    name: VIII (G60/G61/G68)
                    cars_qty: 0
                    from_year: 2024
                    to_year: null
                    manufacturer_id: 16
                    model_id: 94
                links:
                  first: https://auctionsapi.com/api/generations/94/cars?page=1
                  last: https://auctionsapi.com/api/generations/94/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/generations/94/cars
                  per_page: 500
                  to: 8
                  total: 8
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /search-vin/{vin}:
    get:
      tags:
        - Main endpoints
      summary: get a car by vin code
      operationId: 083a7dfc9f3bc400b85fda5ace53232d
      parameters:
        - name: vin
          in: path
          required: true
          schema:
            type: string
        - name: prices_history
          in: query
          description: Add price history to response (set value 1 to get prices array)
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: Car info
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  data:
                    $ref: "#/components/schemas/Vehicle"
                description: "Illustrative response: generation.id and seller_reserve are demo values. Get actual generation IDs from /generations/3038/cars."
              example:
                data:
                  id: 16070300
                  year: 2023
                  title: 2023 BMW M8
                  vin: WBSAE0C06PCL70372
                  manufacturer:
                    id: 16
                    name: BMW
                  model:
                    id: 3038
                    name: M8
                    manufacturer_id: 16
                  generation:
                    id: 900001
                    name: I (F92) LCI
                    manufacturer_id: 16
                    model_id: 3038
                  body_type:
                    name: coupe
                    id: 3
                  color:
                    name: green
                    id: 4
                  engine:
                    id: 39
                    name: 4.4l 8
                  transmission:
                    name: automatic
                    id: 1
                  drive_wheel:
                    name: all
                    id: 3
                  vehicle_type:
                    name: automobile
                    id: 1
                  fuel:
                    name: gasoline
                    id: 4
                  cylinders: 8
                  lots:
                    - id: 16447827
                      lot: "94166665"
                      domain:
                        name: copart_com
                        id: 3
                      external_id: null
                      odometer:
                        km: 28218
                        mi: 17534
                        status:
                          name: actual
                          id: 1
                      estimate_repair_price: null
                      pre_accident_price: 88591
                      clean_wholesale_price: 97575
                      actual_cash_value: null
                      sale_date: 2026-03-25T15:55:05.000000Z
                      sale_date_updated_at: 2026-03-26T15:56:32.000000Z
                      bid: 56500
                      bid_updated_at: 2026-03-25T14:01:44.000000Z
                      buy_now: 0
                      buy_now_updated_at: 2026-03-01T23:14:06.000000Z
                      final_bid: 56500
                      final_bid_updated_at: 2026-03-15T03:12:52.000000Z
                      status:
                        name: sold
                        id: 6
                      seller: null
                      seller_type: null
                      title:
                        id: 4235
                        code: null
                        name: Ct - Clean Title
                      detailed_title:
                        id: 1582
                        code: null
                        name: Mi - Certificate Of Title
                      note: null
                      damage:
                        main:
                          id: 37
                          name: Side
                        second:
                          id: 3
                          name: Front End
                      keys_available: true
                      airbags: null
                      condition:
                        name: run_and_drives
                        id: 0
                      grade_iaai: null
                      images:
                        id: 19358054
                        small:
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_thb.jpg
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_thb.jpg
                        normal:
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg
                        big:
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg
                          - https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg
                        exterior: null
                        interior: null
                        video: https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/986c53a65f76451ab653fc6492983720_O.mp4
                        video_youtube_id: null
                        external_panorama_url: null
                        downloaded:
                          - https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-1.webp
                          - https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-2.webp
                      location:
                        country:
                          iso: us
                          name: USA
                        state:
                          id: 82
                          code: mi
                          name: michigan
                        city:
                          id: 75
                          name: davison
                        location:
                          id: 88
                          name: mi - flint
                        latitude: 43.07812
                        longitude: -83.51813
                        postal_code: 48423 8502
                        is_offsite: null
                        raw: mi - flint
                        offsite: null
                      tags:
                        - CERT-D
                        - IV
                      line: A/92
                      selling_branch:
                        name: mi - flint
                        link: null
                        number: null
                        id: 540618
                        domain_id: 3
                      created_at: 2025-12-01T16:11:02.000000Z
                      updated_at: 2026-03-26T18:07:05.000000Z
                      details: null
                      is_timed_auction: false
                      seller_reserve:
                        price: 55000
                        updated_at: 2026-03-24T10:30:00.000000Z
                      auction_type:
                        name: pure_sale
                        id: 1
                      archived: true
                      archived_at: 2026-03-26T18:01:13.000000Z
                      prices:
                        - id: 9746422
                          lot_id: 16447827
                          bid: 51000
                          final_bid_updated_at: 2026-03-13T18:20:35.000000Z
                          buy_now_price: null
                          sale_date: 2026-03-11T14:00:00.000000Z
                          status:
                            name: not_sold
                            id: 8
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "404":
          description: Vehicle or lot not found.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /search-lot/{lot}/{domain}:
    get:
      tags:
        - Main endpoints
      summary: get a car by lot number
      operationId: cd75179e11ac6615b47b186e61a5a9f7
      parameters:
        - name: lot
          in: path
          required: true
          schema:
            type: string
        - name: prices_history
          in: query
          description: Add price history to response (set value 1 to get prices array)
          required: false
          schema:
            type: integer
        - name: search_by_id
          in: query
          description: Set value 1 for this parameter, if you need to search by IAAI ID instead of lot number (on URL IAAI put ID not lot number)
          required: false
          schema:
            type: integer
        - name: domain
          in: path
          required: true
          description: Source name. Use /search-lot/{lot} when no explicit source filter is needed.
          schema:
            type: string
            enum:
              - copart_com
              - iaai_com
              - encar_com
      responses:
        "200":
          description: Car info
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  data:
                    $ref: "#/components/schemas/Vehicle"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "404":
          description: Vehicle or lot not found.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /archived-lots:
    get:
      tags:
        - Main endpoints
      summary: get archived lots
      operationId: cfb0828078711c33658f96ea26fe6db4
      parameters:
        - name: per_page
          in: query
          required: false
          description: "Archive page size: default 100; Demo/Small maximum 100; Unlimited maximum 1000."
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
        - name: minutes
          in: query
          description: this parameter allows you to retrieve only those lots that have been archived in the last few minutes (max 4320 minutes)
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 4320
          example: "10"
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: simple_paginate
          in: query
          required: false
          description: 1 for simple pagination, 0 to request totals. Explicitly set 1 when totals are not needed; account defaults may vary.
          schema:
            type: integer
            enum:
              - 0
              - 1
      responses:
        "200":
          description: List of archived lots
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ArchiveEvent"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /statistics:
    get:
      tags:
        - Additional endpoints
      summary: get statistics and average prices for all cars, grouped by manufacturer, model, generation, year, vehicle type and platform
      operationId: e9614d1657ad523194b3fd035a4be052
      parameters:
        - name: manufacturer_id
          in: query
          required: false
          description: Manufacturer ID or comma-separated IDs, for example 16,88.
          schema:
            type: string
        - name: model_id
          in: query
          description: Car model id, to get it use /models endpoint
          required: false
          schema:
            type: integer
        - name: generation_id
          in: query
          description: Car generation id, to get it use /generations endpoint
          required: false
          schema:
            type: integer
        - name: engine_id
          in: query
          description: Engine id
          required: false
          schema:
            type: integer
        - name: year
          in: query
          description: Filter with fixed year
          required: false
          schema:
            type: integer
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: per_page
          in: query
          required: false
          description: Default 100, maximum 500. Demo accounts may be limited to 10.
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 500
      responses:
        "200":
          description: Statistical data
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Statistic"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /korea-duplicates:
    get:
      tags:
        - Additional endpoints
      summary: get ID of duplicated lots
      operationId: b42629564dc449a86b45210940606c12
      parameters:
        - name: minutes
          in: query
          description: this parameter allows you to retrieve only those lots that have been added in the last few minutes (max 4320 minutes)
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 4320
          example: "10"
        - name: per_page
          in: query
          description: how many lots show per page, maximum 5000
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 1000
          example: "1000"
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: lot
          in: query
          required: false
          description: Optional Encar lot number, matching original_id or duplicate_id.
          schema:
            type: integer
      responses:
        "200":
          description: List of duplicated IDs
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/KoreaDuplicate"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /korea-options:
    get:
      tags:
        - Additional endpoints
      summary: get list of default options
      operationId: a09c0adfe59ebbf034a83f9e9664a2e0
      responses:
        "200":
          description: List of duplicated IDs
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/KoreaOption"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /usa/damages:
    get:
      tags:
        - Additional endpoints
      summary: get list of USA damages
      operationId: cae4a412fb92dbdc63485819375f04ad
      parameters:
        - name: page
          in: query
          description: page number
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: List of damages
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ReferenceRecord"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /usa/states:
    get:
      tags:
        - Additional endpoints
      summary: get list of USA and Canada states
      operationId: b26e6d497fa10032893fc7eecb1fcb74
      parameters:
        - name: country
          in: query
          description: "country code: us or ca (default us)"
          required: false
          schema:
            type: string
          example: us
        - name: page
          in: query
          description: page number
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: List of USA/Canada states
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ReferenceRecord"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /usa/cities/{state_id}:
    get:
      tags:
        - Additional endpoints
      summary: get list of cities by state
      operationId: 1ea379b20cf282b37a54f6a522212aa7
      parameters:
        - name: state_id
          in: path
          description: state id
          required: true
          schema:
            type: integer
          example: "12"
        - name: page
          in: query
          description: page number
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: List of cities
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ReferenceRecord"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /usa/titles:
    get:
      tags:
        - Additional endpoints
      summary: get list of USA titles
      operationId: 281b7bbbabb43113c7a0703b1b67a2b1
      parameters:
        - name: page
          in: query
          description: page number
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: List of titles
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ReferenceRecord"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /usa/branches:
    get:
      tags:
        - Additional endpoints
      summary: get list of USA branches
      operationId: 9e84ef416362ca69a3d691de3ffba1f1
      parameters:
        - name: domain_id
          in: query
          description: Filter by domain id (1 and 3 are available options)
          required: false
          schema:
            type: integer
          example: "1"
        - name: page
          in: query
          description: page number
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: List of branches
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/ReferenceRecord"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /manufacturers:
    get:
      tags:
        - Main endpoints
      summary: list all car brands
      operationId: c43da212517d44d769bb785ebe9bb2d2Default
      parameters:
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of manufacturers
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Manufacturer"
              example:
                data:
                  - id: 48
                    name: Ford
                    cars_qty: 93791
                    image: https://auctionsapi.com/images/brands/ford.svg
                    models_qty: 119
                    cars: true
                    motorcycles: false
                  - id: 140
                    name: Toyota
                    cars_qty: 93028
                    image: https://auctionsapi.com/images/brands/toyota.svg
                    models_qty: 180
                    cars: true
                    motorcycles: false
                  - id: 26
                    name: Chevrolet
                    cars_qty: 83914
                    image: https://auctionsapi.com/images/brands/chevrolet.svg
                    models_qty: 126
                    cars: true
                    motorcycles: false
                  - id: 56
                    name: Honda
                    cars_qty: 73667
                    image: https://auctionsapi.com/images/brands/honda.svg
                    models_qty: 90
                    cars: true
                    motorcycles: true
                  - id: 99
                    name: Nissan
                    cars_qty: 64180
                    image: https://auctionsapi.com/images/brands/nissan.svg
                    models_qty: 124
                    cars: true
                    motorcycles: false
                links:
                  first: https://auctionsapi.com/api/manufacturers/cars?page=1
                  last: https://auctionsapi.com/api/manufacturers/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/manufacturers/cars
                  per_page: 1000
                  to: 424
                  total: 424
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /models/{manufacturer_id}:
    get:
      tags:
        - Main endpoints
      summary: list all car models with filter by brand
      operationId: 866de850b4d4bbec2c160c39c8eee84aDefault
      parameters:
        - name: manufacturer_id
          in: path
          required: true
          schema:
            type: integer
          example: "16"
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of car models
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Model"
              example:
                data:
                  - id: 93
                    name: 3er
                    cars_qty: 4746
                    manufacturer_id: 16
                    generations_qty: 7
                  - id: 94
                    name: 5er
                    cars_qty: 2569
                    manufacturer_id: 16
                    generations_qty: 8
                  - id: 1665
                    name: X5
                    cars_qty: 2307
                    manufacturer_id: 16
                    generations_qty: 4
                  - id: 1895
                    name: X3
                    cars_qty: 2207
                    manufacturer_id: 16
                    generations_qty: 3
                  - id: 2070
                    name: 4er
                    cars_qty: 1014
                    manufacturer_id: 16
                    generations_qty: 3
                links:
                  first: https://auctionsapi.com/api/models/16/cars?page=1
                  last: https://auctionsapi.com/api/models/16/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/models/16/cars
                  per_page: 500
                  to: 62
                  total: 62
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /generations/{model_id}:
    get:
      tags:
        - Main endpoints
      summary: list all car generations with filter by model
      operationId: 8d98d611b9e9909cbc4e8f641201744fDefault
      parameters:
        - name: model_id
          in: path
          required: true
          schema:
            type: integer
          example: "94"
        - name: page
          in: query
          required: false
          description: Page number. Keep other filters unchanged.
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        "200":
          description: A list of car generations
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/Page"
                  - type: object
                    additionalProperties: true
                    properties:
                      data:
                        type: array
                        items:
                          $ref: "#/components/schemas/Generation"
              example:
                data:
                  - id: 391
                    name: I (E12)
                    cars_qty: 0
                    from_year: 1972
                    to_year: 1981
                    manufacturer_id: 16
                    model_id: 94
                  - id: 393
                    name: II (E28)
                    cars_qty: 2
                    from_year: 1981
                    to_year: 1988
                    manufacturer_id: 16
                    model_id: 94
                  - id: 394
                    name: III (E34)
                    cars_qty: 11
                    from_year: 1987
                    to_year: 1996
                    manufacturer_id: 16
                    model_id: 94
                  - id: 395
                    name: IV (E39)
                    cars_qty: 54
                    from_year: 1995
                    to_year: 2004
                    manufacturer_id: 16
                    model_id: 94
                  - id: 397
                    name: V (E60/E61)
                    cars_qty: 190
                    from_year: 2002
                    to_year: 2010
                    manufacturer_id: 16
                    model_id: 94
                  - id: 399
                    name: VI (F10/F11/F07)
                    cars_qty: 951
                    from_year: 2009
                    to_year: 2017
                    manufacturer_id: 16
                    model_id: 94
                  - id: 5126
                    name: VII (G30/G31)
                    cars_qty: 714
                    from_year: 2016
                    to_year: 2023
                    manufacturer_id: 16
                    model_id: 94
                  - id: 7288
                    name: VIII (G60/G61/G68)
                    cars_qty: 0
                    from_year: 2024
                    to_year: null
                    manufacturer_id: 16
                    model_id: 94
                links:
                  first: https://auctionsapi.com/api/generations/94/cars?page=1
                  last: https://auctionsapi.com/api/generations/94/cars?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  path: https://auctionsapi.com/api/generations/94/cars
                  per_page: 500
                  to: 8
                  total: 8
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
  /search-lot/{lot}:
    get:
      tags:
        - Main endpoints
      summary: get a car by lot number
      operationId: cd75179e11ac6615b47b186e61a5a9f7Default
      parameters:
        - name: lot
          in: path
          required: true
          schema:
            type: string
        - name: prices_history
          in: query
          description: Add price history to response (set value 1 to get prices array)
          required: false
          schema:
            type: integer
        - name: search_by_id
          in: query
          description: Set value 1 for this parameter, if you need to search by IAAI ID instead of lot number (on URL IAAI put ID not lot number)
          required: false
          schema:
            type: integer
      responses:
        "200":
          description: Car info
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  data:
                    $ref: "#/components/schemas/Vehicle"
        "400":
          description: Invalid request parameter or page size. Correct the request before retrying.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Requested source is not enabled for this key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "403":
          description: Missing, invalid, expired or inactive API key.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "404":
          description: Vehicle or lot not found.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "429":
          description: Request rate limit reached. Respect Retry-After if provided.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          headers:
            Retry-After:
              description: Optional delay in seconds or HTTP date. Not guaranteed on every response.
              schema:
                type: string
        "500":
          description: Unexpected server error. Retry safe reads with a bounded budget.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      description: 'Enter your API key in header x-api-key'
      name: x-api-key
      in: header
  schemas:
    ApiError:
      type: object
      additionalProperties: true
      properties:
        error: &a1
          type: string
          nullable: true
        message: *a1
        errors:
          type: object
          additionalProperties: true
    EnumValue:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        name: *a1
      nullable: true
    SellerReserve:
      type: object
      additionalProperties: true
      properties:
        price: &a2
          anyOf:
            - type: number
              nullable: true
            - type: string
              nullable: true
          description: Numeric value; some sources serialize numeric values as strings.
        updated_at: &a3
          type: string
          format: date-time
          nullable: true
      nullable: true
      description: Seller reserve when available; null otherwise. Not a confirmed final sale price.
      example:
        price: 8500
        updated_at: 2026-09-13T10:30:00.000000Z
    Lot:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        lot:
          anyOf:
            - type: string
            - type: integer
        domain:
          $ref: "#/components/schemas/EnumValue"
        status:
          $ref: "#/components/schemas/EnumValue"
        bid: *a2
        buy_now: *a2
        final_bid: *a2
        seller_reserve:
          $ref: "#/components/schemas/SellerReserve"
        sale_date: *a3
        created_at: *a3
        updated_at: *a3
        archived:
          type: boolean
        archived_at: *a3
        images:
          type: object
          nullable: true
          additionalProperties: true
        location:
          type: object
          nullable: true
          additionalProperties: true
    Vehicle:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        vin: *a1
        title: *a1
        year:
          type: integer
          nullable: true
        manufacturer:
          $ref: "#/components/schemas/EnumValue"
        model:
          $ref: "#/components/schemas/EnumValue"
        generation:
          $ref: "#/components/schemas/EnumValue"
        lots:
          type: array
          items:
            $ref: "#/components/schemas/Lot"
    TimestampedAmount:
      type: object
      additionalProperties: true
      properties:
        value: *a2
        updated_at: *a3
    TimestampedDate:
      type: object
      additionalProperties: true
      properties:
        value: *a3
        updated_at: *a3
    ArchiveCommon:
      type: object
      additionalProperties: true
      properties:
        lot_id:
          type: integer
        car_id:
          type: integer
        vin: *a1
        lot:
          anyOf:
            - type: string
            - type: integer
        domain:
          $ref: "#/components/schemas/EnumValue"
        status:
          $ref: "#/components/schemas/EnumValue"
        archived_at: *a3
    ArchiveLegacy:
      allOf:
        - $ref: "#/components/schemas/ArchiveCommon"
        - type: object
          additionalProperties: true
          properties:
            bid: *a2
            sale_date: *a3
            final_bid_updated_at: *a3
      description: Legacy format. bid may fall back to the current bid; do not assume it is a confirmed sale price.
    ArchiveCurrent:
      allOf:
        - $ref: "#/components/schemas/ArchiveCommon"
        - type: object
          additionalProperties: true
          properties:
            bid:
              $ref: "#/components/schemas/TimestampedAmount"
            buy_now:
              $ref: "#/components/schemas/TimestampedAmount"
            final_bid:
              $ref: "#/components/schemas/TimestampedAmount"
            sale_date:
              $ref: "#/components/schemas/TimestampedDate"
      description: Timestamped archive format returned for some accounts.
    ArchiveEvent:
      anyOf:
        - $ref: "#/components/schemas/ArchiveLegacy"
        - $ref: "#/components/schemas/ArchiveCurrent"
    Page:
      type: object
      additionalProperties: true
      properties:
        data:
          type: array
          items:
            type: object
            additionalProperties: true
        links:
          type: object
          additionalProperties: true
          properties:
            first: *a1
            last: *a1
            prev: *a1
            next: *a1
        meta:
          type: object
          additionalProperties: true
          properties:
            current_page:
              type: integer
            per_page:
              type: integer
            total:
              type: integer
            last_page:
              type: integer
        next_page_url: *a1
        current_page:
          type: integer
        per_page:
          type: integer
      description: Partial pagination envelope. Depending on endpoint/account, next page is links.next or next_page_url. Totals may be absent with simple pagination. Null next link ends traversal.
    ReferenceRecord:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        name: *a1
    Manufacturer:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        name: *a1
        cars_qty:
          type: integer
          nullable: true
        image: *a1
        models_qty:
          type: integer
          nullable: true
        cars:
          type: boolean
        motorcycles:
          type: boolean
    Model:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        name: *a1
        manufacturer_id:
          type: integer
    Generation:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        name: *a1
        manufacturer_id:
          type: integer
        model_id:
          type: integer
    Statistic:
      type: object
      additionalProperties: true
      description: Grouped statistics with manufacturer/model/generation/engine relationships when available. Extra fields are allowed; schema is intentionally partial.
    KoreaDuplicate:
      type: object
      additionalProperties: true
      properties:
        original_id:
          type: integer
        duplicate_id:
          type: integer
        created_at: *a3
    KoreaOption:
      type: object
      additionalProperties: true
      description: Equipment dictionary row; preserve unknown option fields.