openapi: 3.0.3
info:
  title: Nitto Tire USA API
  description: |
    API for the Nitto tire finder.
    **Document last updated:** 2025-04-21
  contact:
    name: API Support
    email: info@entrinix.com
  license:
    name: Proprietary
    url: https://www.entrinix.com/nittotire-api
  version: 3.0.0
servers:
  - url: https://api.nittotire.com
    description: Nitto Tire Production Server
  - url: http://legacy.api.nittotire.test
    description: Nitto Tire Development Server
tags:
  - name: legacy
    description: Legacy endpoints kept for migration reasons.
  - name: system
    description: System functions return *system information* (not related to tire
      products or OE vehicles).
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: By using the authenticate endpoint, you can obtain a token that can
        be used to access secured endpoints.
      scheme: bearer
      bearerFormat: JWT
  parameters:
    AspectRatio:
      name: ar
      description: Aspect ratio to filter with. If a value is passed in, only tires
        with a matching value are returned.
      in: query
      schema:
        type: integer
        enum:
          - 25
          - 30
          - 35
          - 40
          - 45
          - 50
          - 55
          - 60
          - 65
          - 70
          - 75
          - 80
          - 85
        example: 60
    MakeID:
      name: make_id
      description: Unique ID for the make.
      in: query
      schema:
        type: integer
        example: 2
    ModelID:
      name: model_id
      description: Unique ID for the model.
      in: query
      schema:
        type: integer
        example: 4
    OffsetSpeedRanking:
      name: osr
      description: This changes the speed rating offset by a desired amount. For
        example, 1 will allow a V rated tire where H is the max.
      in: query
      schema:
        type: integer
    PlusSize:
      name: plus_size
      description: Plus sizes that should be shown. This can be a value e.g. *1*, a
        comma separated value e.g. *1,2,3,4*, or a range e.g. *0-8*. Use *oe*
        for OE fitments. So *oe-8* returns all plus sizes. *oe,1,3* returns OE,
        +1, and +3 fitments.
      in: query
      schema:
        type: string
        pattern: ^(oe|[0-8])(-[0-8]|,[0-8]+)*$
        example: 1-2
        default: oe
    SectionWidth:
      name: sw
      description: Section width to pass in. If a value is passed in, only tires with
        a matching value are returned.
      in: query
      schema:
        type: integer
        example: 195
    ShowFailed:
      name: show[failed]
      description: Show failed tire information in detail.
      in: query
      schema:
        type: boolean
        default: false
    VehicleID:
      name: vehicle_id
      description: Unique ID value of a given vehicle.
      in: query
      schema:
        type: integer
        example: 1
    Year:
      name: year
      description: Model year of the vehicle.
      in: query
      schema:
        type: integer
        example: 2000
  responses:
    '200':
      description: Successful response.
    '400':
      description: Missing or invalid querystring parameter.
    '404':
      description: No data found.
    '500':
      description: Internal server error.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Internal server error. Please contact support.
              status:
                $ref: '#/components/schemas/StatusError'
  schemas:
    ApiVersion:
      type: string
      description: The API version
      xml:
        attribute: true
      example: 3.2.4
    FRB:
      type: string
      description: Front, rear, or both.
      enum:
        - F
        - R
        - B
      example: F
    LoadIndex:
      type: integer
      nullable: true
      description: Load index for a single tire.
      example: 72
    Message:
      type: string
      description: Human readable information about the returned response.
      example: This is a human readable version of what the returned response means.
    Notes:
      type: string
      nullable: true
      description: Notes specific to the item.
      example: This is a note about the item, saved on Nov 23.
    PlusSize:
      type: integer
      description: Integer representation of the plus size. For example, -1 is OE, 0
        is +0, 1 is +1, etc.
      xml:
        attribute: true
      example: -1
    Performance:
      type: object
      description: Returns basic performance metrics of the API call.
      properties:
        elapsed_seconds:
          type: number
          format: decimal
          description: Elapsed time of API endpoint call in seconds.
          example: 0.0044
        memory_usage_bytes:
          type: integer
          description: Maximum memory used in the call, in bytes.
          example: 1548112
        memory_usage_human:
          type: string
          description: Maximum memory used in the call, in human readable format.
          example: 1.48 MB
    SpeedRating:
      type: string
      description: Speed rating of the tire.
      enum:
        - B
        - C
        - D
        - E
        - F
        - G
        - J
        - K
        - L
        - M
        - 'N'
        - P
        - Q
        - R
        - S
        - T
        - U
        - H
        - V
        - W
        - 'Y'
        - (Y)
        - Z
      example: (Y)
    Stats:
      type: object
      description: Operation statistics
      properties:
        selected:
          type: integer
          description: Number of items selected by this call.
          example: 23
        inserted:
          type: integer
          description: Number of items inserted by this call.
          example: 5
        updated:
          type: integer
          description: Number of items updated by this call.
          example: 3
        deleted:
          type: integer
          description: Number of items deleted by this call.
          example: 1
      additionalProperties: false
    Status:
      type: string
      description: |-
        Status of the output.

        Error = There were errors in the request and data was not returned.

        Info = Request returned data, no processing was done.

        Success = Request processed data and returned data with no errors.

        Warning = Request returned null or some data (not all) was returned.
      enum:
        - error
        - info
        - success
        - warning
      example: success
    StatusError:
      type: string
      description: Error message if the status is error.
      example: Error
    TireMetric:
      type: string
      description: Metric of the tire.
      enum:
        - Flotation
        - LT-Metric
        - Metric
        - PAX
        - P-Metric
        - Spare
      example: LT-Metric
    TireSize:
      type: string
      description: Full tire size including load index, speed rating, and tire type.
      example: 145/65R15 111T XL
    UnitsWeights:
      type: string
      description: Units for the weight, lbs.
      example: lbs
    UTQG:
      type: string
      description: UTQG for the tire.
      example: 500 A A
    Version:
      type: string
      description: Version of the API.
      example: 2.5.0
    Weight:
      type: integer
      nullable: true
      description: Weight of the product, in lbs or kg.
      example: 100
paths:
  /:
    get:
      operationId: getSystemInfo
      summary: Information about the API.
      description: System information about the API is shown on this endpoint.
      security: []
      tags:
        - system
      responses:
        '200':
          description: Returns app name, environment, and versions of the API.
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: object
                    description: Data for the output.
                    properties:
                      app_name:
                        type: string
                        description: Name of the application.
                        example: Nitto Tire USA API
                      environment:
                        type: string
                        description: Environment of the application.
                        enum:
                          - development
                          - testing
                          - production
                      server_name:
                        type: string
                        description: Domain name of the server.
                        example: api.nittotire.com
                      version:
                        $ref: '#/components/schemas/Version'
                  message:
                    $ref: '#/components/schemas/Message'
                  performance:
                    $ref: '#/components/schemas/Performance'
                  stats:
                    $ref: '#/components/schemas/Stats'
                  status:
                    $ref: '#/components/schemas/Status'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
  /cache:
    get:
      operationId: getCacheInfo
      summary: Number of endpoints that are cached.
      description: Returns the number of endpoints that are cached.
      security:
        - bearerAuth: []
      tags:
        - system
      responses:
        '200':
          description: Returns information about the cache.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Data regarding the cache.
                    properties:
                      cache_file_count:
                        type: integer
                        description: Number of cache files, representing a unique endpoint.
                        example: 23
                  message:
                    type: string
                    description: Human readable output message.
                    example: Cache path found with `22` cache files.
                  performance:
                    $ref: '#/components/schemas/Performance'
                  stats:
                    $ref: '#/components/schemas/Stats'
                  status:
                    $ref: '#/components/schemas/Status'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
    post:
      operationId: purgeCache
      summary: Purge/flush all of the cache files.
      description: Clear out all cache files so each request goes through the full
        lifecycle to retrieve the latest data.
      security:
        - bearerAuth: []
      tags:
        - system
      responses:
        '200':
          $ref: '#/components/responses/200'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
  /service:
    get:
      operationId: listTireFinderServiceXml
      summary: Legacy version of the tire finder service with newer features added in.
      description: Returns array of years, makes, models, vehicles, and then tire
        fitments of vehicles in JSON format based on the parameters provided.
        This endpoint follows the exact same logic and process as the previous
        version of the tire finder service. It is used to maintain compatibility
        with older versions of the API.
      security: []
      parameters:
        - $ref: '#/components/parameters/MakeID'
        - $ref: '#/components/parameters/ModelID'
        - $ref: '#/components/parameters/OffsetSpeedRanking'
        - $ref: '#/components/parameters/PlusSize'
        - $ref: '#/components/parameters/ShowFailed'
        - $ref: '#/components/parameters/VehicleID'
        - $ref: '#/components/parameters/Year'
      tags:
        - legacy
      responses:
        '200':
          description: Returns a list of years, makes, models, vehicles, and then tire
            fitments of tires found by the Tire Finder Service.
          content:
            application/xml:
              schema:
                type: object
                xml:
                  name: root
                properties:
                  apiversion:
                    $ref: '#/components/schemas/ApiVersion'
                  failure:
                    type: array
                    xml:
                      name: failure
                      wrapped: false
                    items:
                      type: object
                      properties:
                        plussize:
                          $ref: '#/components/schemas/PlusSize'
                        failed:
                          type: array
                          xml:
                            name: failed
                            wrapped: false
                          items:
                            type: object
                            properties:
                              reasons:
                                type: object
                                properties:
                                  reason:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        code:
                                          type: string
                                          xml:
                                            attribute: true
                                          example: speed_rating
                                        value:
                                          type: string
                                          xml:
                                            name: '#value'
                                          example: Vehicle OE tire speed rating is `H (rank 18)` but replacement tire is
                                            not high enough at `T (rank 16)`.
                                            Speed rating offset of `-1` with
                                            offset type `vehicle`.
                                    xml:
                                      name: reason
                                      wrapped: false
                              tire:
                                type: object
                                xml:
                                  name: tire
                                properties:
                                  id:
                                    type: integer
                                    description: The ID of the tire.
                                    xml:
                                      attribute: true
                                    example: 1282
                                  sku:
                                    type: string
                                    xml:
                                      attribute: true
                                    example: '452420'
                                  load_index:
                                    $ref: '#/components/schemas/LoadIndex'
                                  product_group:
                                    type: string
                                  speed_rating:
                                    $ref: '#/components/schemas/SpeedRating'
                                  tire_size:
                                    $ref: '#/components/schemas/TireSize'
                  make_id:
                    type: number
                    xml:
                      attribute: true
                    example: 23
                  makes:
                    type: object
                    xml:
                      name: makes
                    properties:
                      make:
                        type: array
                        xml:
                          wrapped: false
                        items:
                          type: object
                          xml:
                            name: make
                          properties:
                            id:
                              type: number
                              xml:
                                attribute: true
                              example: 23
                            value:
                              type: string
                              xml:
                                name: '#text'
                              example: Acura
                  model_id:
                    type: number
                    xml:
                      attribute: true
                    example: 123
                  models:
                    type: object
                    xml:
                      name: models
                    properties:
                      model:
                        type: array
                        xml:
                          wrapped: false
                        items:
                          type: object
                          xml:
                            name: model
                          properties:
                            id:
                              type: integer
                              xml:
                                attribute: true
                              example: 123
                            value:
                              type: string
                              xml:
                                name: '#text'
                  qs_make:
                    type: number
                    description: Query parameter to pass in if year is entered.
                    xml:
                      attribute: true
                    example: 23
                  qs_model:
                    type: number
                    xml:
                      attribute: true
                    example: 123
                  qs_plus_size:
                    type: string
                    xml:
                      attribute: true
                    example: all
                  qs_vehicle:
                    type: number
                    xml:
                      attribute: true
                    example: 10444
                  qs_year:
                    type: string
                    description: Query parameter to pass i nothing is entered.
                    example: year
                  vehicle_id:
                    type: integer
                    xml:
                      attribute: true
                    example: 10444
                  vehicle:
                    type: object
                    xml:
                      name: vehicle
                    properties:
                      make:
                        type: string
                        xml:
                          attribute: true
                        example: Toyota
                      model:
                        type: string
                        xml:
                          attribute: true
                        example: 4Runner
                      option:
                        type: string
                        xml:
                          attribute: true
                        example: Limited
                      year:
                        type: integer
                        xml:
                          attribute: true
                        example: 2021
                      type:
                        type: object
                        xml:
                          name: type
                        properties:
                          code:
                            type: string
                            xml:
                              attribute: true
                            example: suv
                          value:
                            type: string
                            xml:
                              name: '#text'
                            example: Full-Size SUV
                      oemtire:
                        type: object
                        xml:
                          name: oemtire
                        properties:
                          tiresize:
                            $ref: '#/components/schemas/TireSize'
                          metric:
                            $ref: '#/components/schemas/TireMetric'
                          rimsize:
                            type: string
                          wbc:
                            type: string
                            example: ''
                          notes:
                            $ref: '#/components/schemas/Notes'
                          loads:
                            type: object
                            properties:
                              load:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    position:
                                      type: string
                                      enum:
                                        - F
                                        - R
                                      xml:
                                        attribute: true
                                      example: F
                                    units:
                                      type: string
                                      xml:
                                        attribute: true
                                      example: lbs
                                    value:
                                      type: integer
                                      xml:
                                        name: '#text'
                                      example: 1972
                                xml:
                                  name: load
                                  wrapped: false
                          inflations:
                            type: object
                            properties:
                              inflation:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    position:
                                      type: string
                                      enum:
                                        - F
                                        - R
                                      xml:
                                        attribute: true
                                      example: F
                                    units:
                                      type: string
                                      xml:
                                        attribute: true
                                      example: lbs
                                    value:
                                      type: integer
                                      xml:
                                        name: '#text'
                                      example: 32
                                xml:
                                  name: inflation
                                  wrapped: false
                          standardopt:
                            type: integer
                            enum:
                              - 0
                              - 1
                            example: 1
                          frb:
                            $ref: '#/components/schemas/FRB'
                          loadindex:
                            $ref: '#/components/schemas/LoadIndex'
                          speedrating:
                            $ref: '#/components/schemas/SpeedRating'
                          loaddesc:
                            type: object
                            properties:
                              code:
                                type: string
                                enum:
                                  - SL
                                  - LL
                                  - XL
                                  - RD
                                xml:
                                  attribute: true
                                example: SL
                              value:
                                type: string
                                xml:
                                  name: '#text'
                                example: Standard Load
                      weights:
                        type: object
                        properties:
                          weight1:
                            type: object
                            properties:
                              units:
                                allOf:
                                  - $ref: '#/components/schemas/UnitsWeights'
                                  - type: string
                                    xml:
                                      attribute: true
                              value:
                                allOf:
                                  - $ref: '#/components/schemas/Weight'
                                  - type: integer
                                    xml:
                                      name: '#text'
                          weight2:
                            type: object
                            properties:
                              units:
                                allOf:
                                  - $ref: '#/components/schemas/UnitsWeights'
                                  - type: string
                                    xml:
                                      attribute: true
                              value:
                                allOf:
                                  - $ref: '#/components/schemas/Weight'
                                  - type: integer
                                    xml:
                                      name: '#text'
                      Replacements:
                        type: object
                        xml:
                          name: replacements
                        properties:
                          maxplussize:
                            oneOf:
                              - type: string
                              - type: integer
                            xml:
                              attribute: true
                            example: 8
                          replacement:
                            type: array
                            items:
                              type: object
                              xml:
                                name: replacement
                              properties:
                                count:
                                  type: integer
                                  xml:
                                    attribute: true
                                  example: 1
                                display:
                                  type: string
                                  xml:
                                    attribute: true
                                  example: OE
                                plussize:
                                  $ref: '#/components/schemas/PlusSize'
                                tire:
                                  type: object
                                  properties:
                                    code:
                                      type: string
                                      xml:
                                        attribute: true
                                      example: '233322'
                                    group:
                                      type: integer
                                      description: Group ID the tire belongs to. Used mostly internally.
                                      xml:
                                        attribute: true
                                      example: 46
                                    tiretype:
                                      type: integer
                                      description: Tire type ID the tire belongs to. Used mostly internally.
                                      xml:
                                        attribute: true
                                      example: 10
                                    name:
                                      type: string
                                      description: Name of the Nitto tire.
                                      example: Nomad Grappler
                                    tiresize:
                                      $ref: '#/components/schemas/TireSize'
                                    metric:
                                      $ref: '#/components/schemas/TireMetric'
                                    weight:
                                      type: object
                                      properties:
                                        units:
                                          allOf:
                                            - $ref: '#/components/schemas/UnitsWeights'
                                            - type: string
                                              xml:
                                                attribute: true
                                        value:
                                          type: number
                                          format: decimal
                                          xml:
                                            name: '#text'
                                          example: 27.5
                                    loadindex:
                                      $ref: '#/components/schemas/LoadIndex'
                                    speedrating:
                                      $ref: '#/components/schemas/SpeedRating'
                                    oad:
                                      type: object
                                      properties:
                                        units:
                                          type: string
                                          xml:
                                            attribute: true
                                          example: in
                                        value:
                                          type: number
                                          xml:
                                            name: '#text'
                                          example: 31.6
                                    oaw:
                                      type: object
                                      properties:
                                        units:
                                          type: string
                                          xml:
                                            attribute: true
                                          example: in
                                        value:
                                          type: number
                                          xml:
                                            name: '#text'
                                          example: 9.76
                                    rimwidths:
                                      type: string
                                      example: 7.0-(7.0)-8.5
                                    revspermile:
                                      type: integer
                                      example: 658
                                    notes:
                                      $ref: '#/components/schemas/Notes'
                                    description:
                                      type: string
                                      description: Description of the tire.
                                      example: The Nomad Grappler is a performance SUV tire.
                                    utqg:
                                      $ref: '#/components/schemas/UTQG'
                                    warnings:
                                      type: object
                                      properties:
                                        pressure:
                                          type: string
                                          description: Warnings related to tire pressure.
                                          nullable: true
                                          example: Minimum OE tire pressure (32/32 psi) enabled. Original replacement tire
                                            pressures are (30/30 psi).
                                    ratings:
                                      type: object
                                      properties:
                                        drytraction:
                                          type: number
                                          format: decimal
                                          example: 1.5
                                        quietride:
                                          type: number
                                          format: decimal
                                          example: 2.5
                                        offroad:
                                          type: number
                                          format: decimal
                                          example: 5
                                        wettraction:
                                          type: number
                                          format: decimal
                                          example: 4
                                        ridecomfort:
                                          type: number
                                          format: decimal
                                          example: 4
                                        treadwear:
                                          type: number
                                          format: decimal
                                          example: 4
                                        roadrace:
                                          type: number
                                          format: decimal
                                          example: 4
                                        dragrace:
                                          type: number
                                          format: decimal
                                          example: 4
                                    inflations:
                                      type: object
                                      properties:
                                        inflation:
                                          type: array
                                          items:
                                            type: object
                                            xml:
                                              name: inflation
                                            properties:
                                              position:
                                                type: string
                                                xml:
                                                  attribute: true
                                                example: F
                                              units:
                                                type: string
                                                xml:
                                                  attribute: true
                                                example: psi
                                              value:
                                                type: integer
                                                xml:
                                                  name: '#text'
                                                example: 32
                                      xml:
                                        wrapped: false
                  vehicles:
                    type: object
                    xml:
                      name: vehicles
                    properties:
                      vehicle:
                        type: array
                        xml:
                          wrapped: false
                        items:
                          type: object
                          xml:
                            name: vehicle
                          properties:
                            id:
                              type: string
                              xml:
                                attribute: true
                              example: '11'
                            frb:
                              allOf:
                                - $ref: '#/components/schemas/FRB'
                                - type: string
                                  xml:
                                    attribute: true
                            size:
                              type: string
                              xml:
                                attribute: true
                            load_index:
                              allOf:
                                - $ref: '#/components/schemas/LoadIndex'
                                - type: integer
                                  xml:
                                    attribute: true
                              example: 100
                              minimum: 50
                              maximum: 200
                            speed_rating:
                              allOf:
                                - $ref: '#/components/schemas/SpeedRating'
                                - type: string
                                  xml:
                                    attribute: true
                            code:
                              type: string
                              xml:
                                attribute: true
                              example: suv
                            vehicle_type:
                              type: string
                              xml:
                                attribute: true
                              example: Full-Size SUV
                            value:
                              type: string
                              xml:
                                name: '#text'
                              example: TRD Off-Road
                  year:
                    type: integer
                    description: Year provided in the request.
                    xml:
                      attribute: true
                    example: 2021
                  years:
                    type: object
                    xml:
                      wrapped: true
                    properties:
                      year:
                        type: array
                        items:
                          type: integer
                          description: A specific year
                          example: 2023
                required:
                  - years
        '400':
          $ref: '#/components/responses/400'
        '500':
          $ref: '#/components/responses/500'
  /service/json:
    get:
      operationId: listTireFinderServiceJson
      summary: Legacy version of the tire finder service with newer features added in.
      description: This endpoint follows the exact same logic and process as the
        previous version of the tire finder service. It is used to maintain
        compatibility with older versions of the API.
      security: []
      parameters:
        - $ref: '#/components/parameters/MakeID'
        - $ref: '#/components/parameters/ModelID'
        - $ref: '#/components/parameters/OffsetSpeedRanking'
        - $ref: '#/components/parameters/PlusSize'
        - $ref: '#/components/parameters/ShowFailed'
        - $ref: '#/components/parameters/VehicleID'
        - $ref: '#/components/parameters/Year'
      tags:
        - legacy
      responses:
        '200':
          description: Returns array of years, makes, models, vehicles, and then tire
            fitments of vehicles in JSON format based on the parameters
            provided.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@attributes':
                    type: object
                    properties:
                      send:
                        type: string
                        enum:
                          - year
                    required:
                      - send
                  version:
                    type: string
                    example: 3.2.4
                  years:
                    type: array
                    description: Returns a list of years if no parameters are provided.
                    items:
                      type: integer
                      minimum: 1980
                      maximum: 2030
                    minItems: 0
                    uniqueItems: true
                  makes:
                    type: array
                    description: Returns a list of makes if the 'year' query parameter is provided.
                    items:
                      type: object
                      required:
                        - id
                        - title
                      properties:
                        id:
                          type: string
                          description: The value of make to pass in as the 'make_id'.
                          example: "1"
                        title:
                          type: string
                          description: Name of the make.
                          example: Acura
                  models:
                    type: array
                    description: Returned if 'make_id' query parameter is provided.
                    items:
                      type: object
                      required:
                        - id
                        - title
                      properties:
                        id:
                          type: string
                          description: The ID of the model which should be passed as 'model_id'.
                          example: "4"
                        title:
                          type: string
                          description: Name of the model.
                          example: NSX
                  vehicles:
                    type: object
                    description: Returned if 'model_id' query parameter is provided. The model_id value must be one of the models returned in the list of models.
                    additionalProperties:
                      type: object
                      description: Each property is a vehicle ID, and needs to be passed in to get fitments. Each key is a vehicle_id (e.g., "76731", "76732").
                      properties:
                        frb:
                          $ref: '#/components/schemas/FRB'
                        speed_rating:
                          $ref: '#/components/schemas/SpeedRating'
                        tire_size:
                          $ref: '#/components/schemas/TireSize'
                        load_index:
                          $ref: '#/components/schemas/LoadIndex'
                        vehicle_option:
                          type: string
                          example: "4x2"
                        vehicle_type:
                          type: string
                          description: Human readable type of vehicle.
                          example: "Large SUV"
                        code:
                          type: string
                          description: Type of vehicle.
                          example: "SUV"
                  make_id:
                    type: integer
                    description: Returned if 'make_id' query parameter is provided.
                    minimum: 1
                    example: 55
                  year:
                    type: integer
                    description: Returned if 'year' query parameter is provided.
                    minimum: 1980
                    maximum: 2025
                    example: 2000
                required:
                  - '@attributes'
                  - version
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
  /service/size:
    get:
      operationId: listTireFinderSizes
      summary: Legacy version of the Tire Finder that returns all available Nitto tire
        sizes.
      description: Returns array of section widths, makes, models, vehicles, and then
        tire fitments of vehicles in JSON format based on the parameters
        provided. This endpoint follows the exact same logic and process as the
        previous version of the tire finder service. It is used to maintain
        compatibility with older versions of the API.
      security: []
      parameters:
        - $ref: '#/components/parameters/AspectRatio'
        - $ref: '#/components/parameters/SectionWidth'
      tags:
        - legacy
      responses:
        '200':
          description: Returns a list of  years, makes, models, vehicles, and then tire
            fitments of tires found by the Tire Finder Service.
          content:
            application/xml:
              schema:
                type: object
                xml:
                  name: root
                properties:
                  apiversion:
                    $ref: '#/components/schemas/ApiVersion'
                  ar:
                    type: string
                    xml:
                      attribute: true
                    example: '45'
                  aspect_ratios:
                    type: object
                    description: This node only appears if the section width is provided.
                    xml:
                      name: aspect_ratios
                    properties:
                      ar:
                        type: array
                        items:
                          type: integer
                          xml:
                            name: ar
                        example:
                          - 30
                          - 35
                          - 40
                          - 45
                          - 50
                          - 55
                          - 60
                          - 65
                          - 70
                  rd:
                    type: string
                    description: Returns the rim diameter in inches if the parameter rim diameter is
                      provided.
                    xml:
                      attribute: true
                    example: '20'
                  results:
                    type: object
                    description: This node only appears if the section width, aspect ratio, and rim
                      diameter are provided.
                    xml:
                      name: results
                    properties:
                      tire_info:
                        type: array
                        items:
                          type: object
                          xml:
                            name: tire_info
                          properties:
                            product_code:
                              type: string
                              example: '202990'
                            description:
                              type: string
                              example: Luxury Sport Ultra High Performance Radial
                            images:
                              type: array
                              items:
                                type: string
                            is_new:
                              type: integer
                              description: 1 if the tire is new, 0 if the tire is no longer considered new.
                              example: 0
                            load_index:
                              type: object
                              properties:
                                tire:
                                  type: string
                                  enum:
                                    - single
                                  xml:
                                    attribute: true
                                value:
                                  type: integer
                                  xml:
                                    name: '#text'
                                  example: 74
                            load_index_dual:
                              type: object
                              properties:
                                tire:
                                  type: string
                                  enum:
                                    - dual
                                  xml:
                                    attribute: true
                                value:
                                  type: integer
                                  xml:
                                    name: '#text'
                                  example: 72
                            load_range:
                              type: string
                              example: XL
                            max_load:
                              type: object
                              properties:
                                tire:
                                  type: string
                                  enum:
                                    - single
                                  xml:
                                    attribute: true
                                units:
                                  type: string
                                  example: lbs
                                  xml:
                                    attribute: true
                                value:
                                  type: integer
                                  example: 2039
                                  xml:
                                    name: '#text'
                            max_load_dual:
                              type: object
                              properties:
                                tire:
                                  type: string
                                  enum:
                                    - dual
                                  xml:
                                    attribute: true
                                units:
                                  type: string
                                  xml:
                                    attribute: true
                                  example: lbs
                                value:
                                  type: integer
                                  example: 2039
                                  xml:
                                    name: '#text'
                              xml:
                                name: max_load_dual
                            max_pressure:
                              type: object
                              properties:
                                tire:
                                  type: string
                                  enum:
                                    - single
                                    - dual
                                  xml:
                                    attribute: true
                                units:
                                  type: string
                                  example: psi
                                  xml:
                                    attribute: true
                                value:
                                  type: integer
                                  example: 50
                                  xml:
                                    name: '#text'
                            metric:
                              type: string
                              example: Metric
                            name:
                              type: string
                              example: INVO
                            overall_section_width:
                              type: object
                              properties:
                                units:
                                  type: string
                                  example: in
                                  xml:
                                    attribute: true
                                value:
                                  type: number
                                  format: float
                                  example: 10.12
                                  xml:
                                    name: '#text'
                            overall_tire_diameter:
                              type: object
                              properties:
                                value:
                                  type: number
                                  xml:
                                    attribute: false
                                    name: '#text'
                                  example: 29
                                units:
                                  type: string
                                  xml:
                                    attribute: true
                                    name: units
                                  example: in
                            revs_per_mile:
                              type: integer
                              example: 716
                            rim_protect:
                              type: string
                              example: ''
                            rim_widths:
                              type: object
                              properties:
                                units:
                                  type: string
                                  xml:
                                    attribute: true
                                  example: in
                                value:
                                  type: string
                                  example: 8.0-(8.5)-9.5
                                  xml:
                                    name: '#text'
                            sidewall:
                              type: string
                              example: ''
                            speed_rating:
                              type: string
                              example: W
                            tire_size:
                              type: string
                              example: 255/45ZR20 101W
                            tread_depth:
                              type: object
                              properties:
                                units:
                                  type: string
                                  example: in
                                  xml:
                                    attribute: true
                                value:
                                  type: string
                                  example: 10.0/32
                                  xml:
                                    name: '#text'
                            url:
                              type: string
                              description: URL to the tire product page.
                              example: ''
                            utqg:
                              type: string
                              example: 260 AA A
                            weight:
                              type: object
                              properties:
                                units:
                                  type: string
                                  example: lbs
                                  xml:
                                    attribute: true
                                value:
                                  type: number
                                  format: float
                                  example: 33.4
                                  xml:
                                    name: '#text'
                  rim_diameters:
                    type: array
                    items:
                      type: string
                      xml:
                        name: rd
                    example:
                      - '17.0'
                      - '18.0'
                      - '19.0'
                      - '20.0'
                  send:
                    type: string
                    xml:
                      attribute: true
                    example: sw
                  section_widths:
                    type: object
                    xml:
                      name: section_widths
                    properties:
                      sw:
                        type: array
                        items:
                          type: string
                          example: '255'
                        xml:
                          name: sw
                          wrapped: false
                  sw:
                    type: string
                    xml:
                      attribute: true
                    example: '255'
        '400':
          $ref: '#/components/responses/400'
        '500':
          $ref: '#/components/responses/500'
  /service/size/json:
    get:
      operationId: listTireFinderSizesJson
      summary: Return all available Nitto tire sizes.
      description: Returns array of section widths, makes, models, vehicles, and then
        tire fitments of vehicles in JSON format based on the parameters
        provided. This endpoint follows the exact same logic and process as the
        previous version of the tire finder service. It is used to maintain
        compatibility with older versions of the API.
      security: []
      parameters:
        - $ref: '#/components/parameters/AspectRatio'
        - $ref: '#/components/parameters/SectionWidth'
      tags:
        - legacy
      responses:
        '200':
          description: Returns a list of tire size information for Nitto tires.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@attributes':
                    type: object
                    properties:
                      send:
                        type: string
                        example: sw
                      sw:
                        type: string
                        example: "185"
                      ar:
                        type: string
                        example: "60"
                      rd:
                        type: string
                        example: "15"
                  ar:
                    type: array
                    description: List of aspect ratios for a given section width. Only displays when the parameter sw is passed in as a parameter with a valid section width.
                    items:
                      type: integer
                    example: [60, 65, 70]
                  rd:
                    type: array
                    description: List of rim diameters for a given section width and aspect ratio. Only displays when sw and ar are passed in.
                    items:
                      type: string
                    example: ["15.0"]
                  sw:
                    type: array
                    items:
                      oneOf:
                        - type: integer
                        - type: string
                    example:
                      - 175
                      - 185
                      - 195
                      - 205
                      - 215
                      - 225
                      - 235
                      - 245
                      - 255
                      - 265
                      - 275
                      - 285
                      - 295
                      - 305
                      - 315
                      - 325
                      - 335
                      - 345
                      - LT235
                      - LT245
                      - LT255
                      - LT265
                      - LT275
                      - LT285
                      - LT295
                      - LT305
                      - LT315
                      - LT325
                      - LT355
                      - LT375
                      - LT385
                      - "30.0"
                      - "32.0"
                      - "32.5"
                      - "33.0"
                      - "34.5"
                      - "34.8"
                      - "35.0"
                      - "36.5"
                      - "37.0"
                      - "37.8"
                      - "38.0"
                      - "40.0"
                      - "41.8"
                      - "42.0"
                  tires:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 834
                        date_created:
                          type: string
                          format: date-time
                          example: "2017-03-03 20:05:35"
                        date_modified:
                          type: string
                          format: date-time
                          example: "2025-02-01 19:37:54"
                        date_valid_until:
                          type: string
                          nullable: true
                          example: null
                        is_active:
                          type: integer
                          example: 1
                        status:
                          type: string
                          nullable: true
                        rank:
                          type: string
                          nullable: true
                        product_group_id:
                          type: integer
                          example: 39
                        product_type_id:
                          type: integer
                          example: 7
                        sku:
                          type: string
                          example: "204160"
                        title:
                          type: string
                          example: "SN2"
                        description:
                          type: string
                          nullable: true
                        qty_in_stock:
                          type: integer
                          nullable: true
                        price:
                          type: number
                          nullable: true
                        weight:
                          type: string
                          example: "16.09"
                        languages:
                          type: array
                          items:
                            type: string
                            example: en
                        notes:
                          type: string
                          nullable: true
                        tags:
                          type: string
                          nullable: true
                        attributes:
                          type: object
                          properties:
                            sfdc_id:
                              type: string
                              example: "01tC0000002wK6JIAU"
                            pattern_sub:
                              type: string
                              example: "Winter"
                            tread_construction:
                              type: string
                              example: "2S+1P+1N"
                            sidewall_construction:
                              type: string
                              example: 1P
                        guid:
                          type: string
                          format: uuid
                          example: "93a9b92f-bdeb-44c0-b349-d7265abd8578"
                        localization:
                          type: string
                          nullable: true
                        brand_id:
                          type: integer
                          example: 1
                        tire_size:
                          type: string
                          example: "185/60R15 84T"
                        tire_metric:
                          type: string
                          example: "Metric"
                        section_width:
                          type: integer
                          example: 185
                        overall_diameter:
                          type: string
                          example: "23.8"
                        aspect_ratio:
                          type: integer
                          example: 60
                        flotation_series:
                          type: string
                          nullable: true
                        rim_diameter:
                          type: string
                          example: "15.0"
                        load_index:
                          type: integer
                          example: 84
                        load_index_dual:
                          type: string
                          nullable: true
                        speed_rating:
                          type: string
                          example: "T"
                        load_range:
                          type: string
                          nullable: true
                        ply_rating:
                          type: string
                          nullable: true
                        approved_rim_widths:
                          type: string
                          example: "5.0-(5.5)-6.5"
                        max_pressure:
                          type: integer
                          example: 44
                        max_pressure_dual:
                          type: integer
                          example: 44
                        max_speed:
                          type: string
                          nullable: true
                        max_load:
                          type: integer
                          example: 1102
                        max_load_dual:
                          type: string
                          nullable: true
                        tread_depth:
                          type: string
                          example: "11.0"
                        overall_section_width:
                          type: string
                          example: "7.20"
                        overall_tire_diameter:
                          type: string
                          example: "23.8"
                        revs_per_mile:
                          type: integer
                          example: 874
                        is_runflat:
                          type: integer
                          example: 0
                        utqg:
                          type: string
                          nullable: true
                          example: null
                        title_group:
                          type: string
                          example: "SN2"
                        description_group:
                          type: string
                          nullable: true
                          example: null
                  version:
                    type: string
                    example: "3.2.4"
