{
  "openapi": "3.0.3",
  "info": {
    "title": "613 Parts Public Filter Lookup",
    "version": "1.0.0",
    "description": "Direct manufacturer references to Baldwin products. Returns public dealer pricing, dated store stock, conditions, sources and canonical product URLs. A reference does not confirm fitment."
  },
  "servers": [
    {
      "url": "https://613parts.ca"
    }
  ],
  "paths": {
    "/api/filters/lookup": {
      "get": {
        "operationId": "lookupFilterNumber",
        "summary": "Find Baldwin references for a filter number",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Filter number, optionally prefixed by manufacturer.",
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": false,
            "description": "Manufacturer, e.g. WIX, GK INDUSTRIES, CATERPILLAR.",
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "name": "store",
            "in": "query",
            "required": false,
            "description": "Preferred store used for ranking, not proof of fitment. 61 Belleville, 62 Kingston.",
            "schema": {
              "type": "string",
              "enum": [
                "61",
                "62"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Result page.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results per page.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matches with source references, product identities, specifications, price (null when expired), store stock, timestamps and fitment_confirmed=false.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schema_version",
                    "query",
                    "match_count",
                    "matches",
                    "source_dates"
                  ],
                  "properties": {
                    "schema_version": {
                      "type": "string"
                    },
                    "query": {
                      "type": "object"
                    },
                    "match_count": {
                      "type": "integer"
                    },
                    "matches": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "source_dates": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "429": {
            "description": "Rate limited; obey Retry-After"
          },
          "503": {
            "description": "Source temporarily unavailable"
          }
        }
      }
    }
  }
}