{
  "components": {
    "schemas": {
      "ApiError": {
        "$id": "ApiError",
        "additionalProperties": false,
        "properties": {
          "error": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[a-z0-9_]+$",
                "type": "string"
              },
              "fields": {
                "items": {
                  "$ref": "#/components/schemas/ApiErrorField"
                },
                "maxItems": 64,
                "type": "array"
              },
              "message": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "request_id": {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "code",
              "message",
              "request_id"
            ],
            "type": "object"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "ApiErrorField": {
        "$id": "ApiErrorField",
        "additionalProperties": false,
        "properties": {
          "code": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9_]+$",
            "type": "string"
          },
          "field": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "message": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "field",
          "code",
          "message"
        ],
        "type": "object"
      },
      "BillingUnit": {
        "$id": "BillingUnit",
        "anyOf": [
          {
            "const": "tokens",
            "type": "string"
          },
          {
            "const": "requests",
            "type": "string"
          },
          {
            "const": "searches",
            "type": "string"
          },
          {
            "const": "documents",
            "type": "string"
          },
          {
            "const": "images",
            "type": "string"
          },
          {
            "const": "seconds",
            "type": "string"
          },
          {
            "const": "characters",
            "type": "string"
          },
          {
            "const": "licenses",
            "type": "string"
          },
          {
            "const": "channel_defined",
            "type": "string"
          }
        ]
      },
      "BusinessCategoryListResponse": {
        "$id": "BusinessCategoryListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/BusinessCategorySummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "BusinessCategoryQuoteOverview": {
        "$id": "BusinessCategoryQuoteOverview",
        "additionalProperties": false,
        "properties": {
          "business_category": {
            "$ref": "#/components/schemas/BusinessCategorySummary"
          },
          "components": {
            "items": {
              "$ref": "#/components/schemas/QuoteRateComponent"
            },
            "maxItems": 32,
            "minItems": 1,
            "type": "array"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "information_channel": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CompactInformationChannel"
              },
              {
                "type": "null"
              }
            ]
          },
          "market_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MarketScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "offering_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "provenance": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/QuoteProvenance"
              },
              {
                "type": "null"
              }
            ]
          },
          "selection_reason": {
            "anyOf": [
              {
                "const": "unique_standard_offering",
                "type": "string"
              },
              {
                "const": "baseline_missing",
                "type": "string"
              },
              {
                "const": "scope_unreviewed",
                "type": "string"
              },
              {
                "const": "manufacturer_unresolved",
                "type": "string"
              },
              {
                "const": "offering_ambiguous",
                "type": "string"
              },
              {
                "const": "multiple_tiers",
                "type": "string"
              },
              {
                "const": "conditions_incomplete",
                "type": "string"
              },
              {
                "const": "disputed",
                "type": "string"
              },
              {
                "const": "aging",
                "type": "string"
              },
              {
                "const": "stale",
                "type": "string"
              }
            ]
          },
          "selection_status": {
            "anyOf": [
              {
                "const": "selected",
                "type": "string"
              },
              {
                "const": "unavailable",
                "type": "string"
              }
            ]
          },
          "tier_status": {
            "anyOf": [
              {
                "const": "standard",
                "type": "string"
              },
              {
                "const": "multiple_tiers",
                "type": "string"
              },
              {
                "const": "unavailable",
                "type": "string"
              }
            ]
          },
          "used_mainland_fallback": {
            "type": "boolean"
          },
          "verification_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VerificationStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "business_category",
          "information_channel",
          "market_scope",
          "used_mainland_fallback",
          "selection_status",
          "selection_reason",
          "offering_id",
          "tier_status",
          "components",
          "verification_status",
          "freshness",
          "observed_at",
          "provenance"
        ],
        "type": "object"
      },
      "BusinessCategorySummary": {
        "$id": "BusinessCategorySummary",
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "information_channel_count": {
            "minimum": 0,
            "type": "integer"
          },
          "manufacturer_count": {
            "minimum": 0,
            "type": "integer"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "status"
        ],
        "type": "object"
      },
      "CatalogFacetBusinessCategory": {
        "$id": "CatalogFacetBusinessCategory",
        "additionalProperties": false,
        "properties": {
          "business_category": {
            "$ref": "#/components/schemas/BusinessCategorySummary"
          },
          "matching_model_count": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "business_category",
          "matching_model_count"
        ],
        "type": "object"
      },
      "CatalogFacetChannel": {
        "$id": "CatalogFacetChannel",
        "additionalProperties": false,
        "properties": {
          "information_channel": {
            "$ref": "#/components/schemas/InformationChannelSummary"
          },
          "matching_model_count": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "information_channel",
          "matching_model_count"
        ],
        "type": "object"
      },
      "CatalogFacetManufacturer": {
        "$id": "CatalogFacetManufacturer",
        "additionalProperties": false,
        "properties": {
          "matching_model_count": {
            "minimum": 1,
            "type": "integer"
          },
          "model_manufacturer": {
            "$ref": "#/components/schemas/ModelManufacturerSummary"
          }
        },
        "required": [
          "model_manufacturer",
          "matching_model_count"
        ],
        "type": "object"
      },
      "CatalogFacetModelType": {
        "$id": "CatalogFacetModelType",
        "additionalProperties": false,
        "properties": {
          "matching_model_count": {
            "minimum": 0,
            "type": "integer"
          },
          "model_type": {
            "$ref": "#/components/schemas/ModelType"
          }
        },
        "required": [
          "model_type",
          "matching_model_count"
        ],
        "type": "object"
      },
      "CatalogFacetsResponse": {
        "$id": "CatalogFacetsResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "additionalProperties": false,
            "properties": {
              "business_categories": {
                "items": {
                  "$ref": "#/components/schemas/CatalogFacetBusinessCategory"
                },
                "maxItems": 64,
                "type": "array"
              },
              "information_channels": {
                "items": {
                  "$ref": "#/components/schemas/CatalogFacetChannel"
                },
                "maxItems": 64,
                "type": "array"
              },
              "model_manufacturers": {
                "items": {
                  "$ref": "#/components/schemas/CatalogFacetManufacturer"
                },
                "maxItems": 256,
                "type": "array"
              },
              "model_types": {
                "items": {
                  "$ref": "#/components/schemas/CatalogFacetModelType"
                },
                "maxItems": 5,
                "type": "array"
              },
              "total_count": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "business_categories",
              "information_channels",
              "model_manufacturers",
              "model_types",
              "total_count"
            ],
            "type": "object"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "CatalogQualityGate": {
        "$id": "CatalogQualityGate",
        "additionalProperties": false,
        "properties": {
          "blocking_count": {
            "minimum": 0,
            "type": "integer"
          },
          "catalog_epoch": {
            "pattern": "^(?:0|[1-9][0-9]*)$",
            "type": "string"
          },
          "finding_counts": {
            "maxProperties": 64,
            "patternProperties": {
              "^[a-z0-9_]+$": {
                "minimum": 1,
                "type": "integer"
              }
            },
            "type": "object"
          },
          "snapshot_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "pass",
                "type": "string"
              },
              {
                "const": "blocked",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "catalog_epoch",
          "snapshot_at",
          "status",
          "blocking_count",
          "finding_counts"
        ],
        "type": "object"
      },
      "CatalogSummaryResponse": {
        "$id": "CatalogSummaryResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "additionalProperties": false,
            "properties": {
              "catalog_epoch": {
                "pattern": "^(?:0|[1-9][0-9]*)$",
                "type": "string"
              },
              "channel_provider_count": {
                "minimum": 0,
                "type": "integer"
              },
              "coverage_denominator": {
                "minimum": 0,
                "type": "integer"
              },
              "coverage_satisfied": {
                "minimum": 0,
                "type": "integer"
              },
              "information_channel_count": {
                "minimum": 0,
                "type": "integer"
              },
              "last_successful_sync_at": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "model_count": {
                "minimum": 0,
                "type": "integer"
              },
              "model_manufacturer_count": {
                "minimum": 0,
                "type": "integer"
              },
              "offering_count": {
                "minimum": 0,
                "type": "integer"
              },
              "official_source_coverage": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/OfficialPriceCoverageSummary"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "quality_gate": {
                "$ref": "#/components/schemas/CatalogQualityGate"
              },
              "source_coverage": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/SourceCoverage"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_statuses": {
                "items": {
                  "$ref": "#/components/schemas/SourceStatus"
                },
                "maxItems": 64,
                "type": "array"
              }
            },
            "required": [
              "model_manufacturer_count",
              "channel_provider_count",
              "information_channel_count",
              "model_count",
              "offering_count",
              "coverage_satisfied",
              "coverage_denominator",
              "catalog_epoch",
              "last_successful_sync_at",
              "source_coverage",
              "official_source_coverage",
              "quality_gate"
            ],
            "type": "object"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "ChannelPriceOverview": {
        "$id": "ChannelPriceOverview",
        "additionalProperties": false,
        "properties": {
          "components": {
            "items": {
              "$ref": "#/components/schemas/QuoteRateComponent"
            },
            "maxItems": 32,
            "minItems": 1,
            "type": "array"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "information_channel": {
            "$ref": "#/components/schemas/InformationChannelSummary"
          },
          "is_default_market": {
            "type": "boolean"
          },
          "market_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MarketScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "offering_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "price_component_count": {
            "minimum": 0,
            "type": "integer"
          },
          "scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InformationChannelScopeSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "selection_reason": {
            "anyOf": [
              {
                "const": "unique_base_offering",
                "type": "string"
              },
              {
                "const": "offering_ambiguous",
                "type": "string"
              },
              {
                "const": "offering_missing",
                "type": "string"
              },
              {
                "const": "historical_only",
                "type": "string"
              }
            ]
          },
          "selection_status": {
            "anyOf": [
              {
                "const": "selected",
                "type": "string"
              },
              {
                "const": "unavailable",
                "type": "string"
              }
            ]
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/QuoteProvenance"
              },
              {
                "type": "null"
              }
            ]
          },
          "used_mainland_fallback": {
            "type": "boolean"
          },
          "verification_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VerificationStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "information_channel",
          "scope",
          "market_scope",
          "is_default_market",
          "used_mainland_fallback",
          "selection_status",
          "selection_reason",
          "offering_id",
          "offering_count",
          "price_component_count",
          "components",
          "verification_status",
          "freshness",
          "observed_at",
          "source"
        ],
        "type": "object"
      },
      "ChannelProviderListResponse": {
        "$id": "ChannelProviderListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/ChannelProviderSummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "ChannelProviderSummary": {
        "$id": "ChannelProviderSummary",
        "additionalProperties": false,
        "properties": {
          "channel_count": {
            "minimum": 0,
            "type": "integer"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "status",
          "channel_count",
          "offering_count",
          "freshness"
        ],
        "type": "object"
      },
      "CompactInformationChannel": {
        "$id": "CompactInformationChannel",
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          }
        },
        "required": [
          "id",
          "slug",
          "name"
        ],
        "type": "object"
      },
      "CurrencyCode": {
        "$id": "CurrencyCode",
        "pattern": "^[A-Z]{3}$",
        "type": "string"
      },
      "CursorPage": {
        "$id": "CursorPage",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "next_cursor": {
            "anyOf": [
              {
                "maxLength": 2048,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "previous_cursor": {
            "anyOf": [
              {
                "maxLength": 2048,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "total_count": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "limit",
          "next_cursor"
        ],
        "type": "object"
      },
      "DecimalString": {
        "$id": "DecimalString",
        "pattern": "^(?:0|[1-9][0-9]{0,19})(?:\\.[0-9]{1,18})?$",
        "type": "string"
      },
      "ExchangeRateResponse": {
        "$id": "ExchangeRateResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "additionalProperties": false,
            "properties": {
              "base_currency": {
                "pattern": "^[A-Z]{3}$",
                "type": "string"
              },
              "freshness": {
                "anyOf": [
                  {
                    "const": "fresh",
                    "type": "string"
                  },
                  {
                    "const": "aging",
                    "type": "string"
                  },
                  {
                    "const": "stale",
                    "type": "string"
                  }
                ]
              },
              "observed_at": {
                "format": "date-time",
                "type": "string"
              },
              "quote_currency": {
                "pattern": "^[A-Z]{3}$",
                "type": "string"
              },
              "rate": {
                "$ref": "#/components/schemas/DecimalString"
              },
              "reference_date": {
                "format": "date",
                "type": "string"
              },
              "source": {
                "additionalProperties": false,
                "properties": {
                  "cny_source_slug": {
                    "maxLength": 128,
                    "minLength": 1,
                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                    "type": "string"
                  },
                  "cny_source_url": {
                    "format": "uri",
                    "type": "string"
                  },
                  "usd_source_slug": {
                    "maxLength": 128,
                    "minLength": 1,
                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                    "type": "string"
                  },
                  "usd_source_url": {
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "usd_source_slug",
                  "usd_source_url",
                  "cny_source_slug",
                  "cny_source_url"
                ],
                "type": "object"
              }
            },
            "required": [
              "base_currency",
              "quote_currency",
              "rate",
              "reference_date",
              "freshness",
              "observed_at",
              "source"
            ],
            "type": "object"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "FreshnessState": {
        "$id": "FreshnessState",
        "anyOf": [
          {
            "const": "fresh",
            "type": "string"
          },
          {
            "const": "aging",
            "type": "string"
          },
          {
            "const": "stale",
            "type": "string"
          },
          {
            "const": "unresolved",
            "type": "string"
          }
        ]
      },
      "HealthResponse": {
        "$id": "HealthResponse",
        "additionalProperties": false,
        "properties": {
          "status": {
            "const": "ok",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "InformationChannelHierarchyResponse": {
        "$id": "InformationChannelHierarchyResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "manufacturers": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "format": "uuid",
                        "type": "string"
                      },
                      "information_channels": {
                        "items": {
                          "additionalProperties": false,
                          "properties": {
                            "channel_provider_id": {
                              "anyOf": [
                                {
                                  "format": "uuid",
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "id": {
                              "format": "uuid",
                              "type": "string"
                            },
                            "market_scopes": {
                              "items": {
                                "$ref": "#/components/schemas/MarketScope"
                              },
                              "maxItems": 2,
                              "type": "array",
                              "uniqueItems": true
                            },
                            "name": {
                              "maxLength": 256,
                              "minLength": 1,
                              "type": "string"
                            },
                            "scope_metrics": {
                              "$ref": "#/components/schemas/InformationChannelScopeMetrics"
                            },
                            "slug": {
                              "maxLength": 128,
                              "minLength": 1,
                              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "channel_provider_id",
                            "market_scopes",
                            "scope_metrics"
                          ],
                          "type": "object"
                        },
                        "maxItems": 256,
                        "type": "array"
                      },
                      "name": {
                        "maxLength": 256,
                        "minLength": 1,
                        "type": "string"
                      },
                      "slug": {
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                        "type": "string"
                      },
                      "status": {
                        "maxLength": 64,
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "slug",
                      "name",
                      "status",
                      "information_channels"
                    ],
                    "type": "object"
                  },
                  "maxItems": 1024,
                  "type": "array"
                },
                "name": {
                  "maxLength": 256,
                  "minLength": 1,
                  "type": "string"
                },
                "slug": {
                  "maxLength": 128,
                  "minLength": 1,
                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                  "type": "string"
                },
                "status": {
                  "anyOf": [
                    {
                      "const": "active",
                      "type": "string"
                    },
                    {
                      "const": "inactive",
                      "type": "string"
                    },
                    {
                      "const": "retired",
                      "type": "string"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "slug",
                "name",
                "status",
                "manufacturers"
              ],
              "type": "object"
            },
            "maxItems": 1024,
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "InformationChannelListResponse": {
        "$id": "InformationChannelListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/InformationChannelSummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "InformationChannelScopeMetrics": {
        "$id": "InformationChannelScopeMetrics",
        "additionalProperties": false,
        "properties": {
          "current_price_component_count": {
            "minimum": 0,
            "type": "integer"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "historical_only_price_component_count": {
            "minimum": 0,
            "type": "integer"
          },
          "historical_price_version_count": {
            "minimum": 0,
            "type": "integer"
          },
          "last_observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "stability_status": {
            "anyOf": [
              {
                "const": "stable",
                "type": "string"
              },
              {
                "const": "not_stable",
                "type": "string"
              },
              {
                "const": "not_measured",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "offering_count",
          "current_price_component_count",
          "historical_only_price_component_count",
          "historical_price_version_count",
          "last_observed_at",
          "freshness",
          "stability_status"
        ],
        "type": "object"
      },
      "InformationChannelScopeSummary": {
        "$id": "InformationChannelScopeSummary",
        "additionalProperties": false,
        "properties": {
          "business_category": {
            "$ref": "#/components/schemas/BusinessCategorySummary"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "manufacturer_id": {
            "format": "uuid",
            "type": "string"
          },
          "market_scopes": {
            "items": {
              "$ref": "#/components/schemas/MarketScope"
            },
            "maxItems": 2,
            "type": "array",
            "uniqueItems": true
          },
          "metrics": {
            "$ref": "#/components/schemas/InformationChannelScopeMetrics"
          },
          "relationship_status": {
            "anyOf": [
              {
                "const": "pending",
                "type": "string"
              },
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          },
          "reviewed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "business_category",
          "manufacturer_id",
          "relationship_status",
          "reviewed_at",
          "market_scopes"
        ],
        "type": "object"
      },
      "InformationChannelSummary": {
        "$id": "InformationChannelSummary",
        "additionalProperties": false,
        "properties": {
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "channel_totals": {
            "$ref": "#/components/schemas/InformationChannelTotals"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "market_scopes": {
            "items": {
              "$ref": "#/components/schemas/MarketScope"
            },
            "maxItems": 2,
            "type": "array",
            "uniqueItems": true
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "scopes": {
            "items": {
              "$ref": "#/components/schemas/InformationChannelScopeSummary"
            },
            "maxItems": 256,
            "type": "array"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "channel_provider_id",
          "status",
          "channel_totals",
          "market_scopes",
          "scopes"
        ],
        "type": "object"
      },
      "InformationChannelTotals": {
        "$id": "InformationChannelTotals",
        "additionalProperties": false,
        "properties": {
          "current_price_component_count": {
            "minimum": 0,
            "type": "integer"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "historical_price_version_count": {
            "minimum": 0,
            "type": "integer"
          },
          "last_observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "offering_count",
          "current_price_component_count",
          "historical_price_version_count",
          "last_observed_at",
          "last_verified_at",
          "freshness"
        ],
        "type": "object"
      },
      "MarketScope": {
        "$id": "MarketScope",
        "anyOf": [
          {
            "const": "mainland_cn",
            "type": "string"
          },
          {
            "const": "international",
            "type": "string"
          },
          {
            "const": "global",
            "type": "string"
          }
        ]
      },
      "ModelDetail": {
        "$id": "ModelDetail",
        "properties": {
          "business_category_quote_overviews": {
            "items": {
              "$ref": "#/components/schemas/BusinessCategoryQuoteOverview"
            },
            "maxItems": 8,
            "type": "array"
          },
          "canonical_name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "capabilities": {
            "items": {
              "anyOf": [
                {
                  "const": "chat",
                  "type": "string"
                },
                {
                  "const": "reasoning",
                  "type": "string"
                },
                {
                  "const": "embedding",
                  "type": "string"
                },
                {
                  "const": "text_output",
                  "type": "string"
                },
                {
                  "const": "image_input",
                  "type": "string"
                },
                {
                  "const": "audio_input",
                  "type": "string"
                },
                {
                  "const": "video_input",
                  "type": "string"
                }
              ]
            },
            "type": "array",
            "uniqueItems": true
          },
          "channel_price_overviews": {
            "items": {
              "$ref": "#/components/schemas/ChannelPriceOverview"
            },
            "maxItems": 64,
            "type": "array"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 20000,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "expiration_date": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "identity_sources": {
            "items": {
              "$ref": "#/components/schemas/ModelIdentitySource"
            },
            "maxItems": 32,
            "type": "array"
          },
          "identity_status": {
            "$ref": "#/components/schemas/ModelIdentityStatus"
          },
          "information_channels": {
            "items": {
              "$ref": "#/components/schemas/ModelInformationChannelReference"
            },
            "maxItems": 64,
            "type": "array",
            "uniqueItems": true
          },
          "input_modalities": {
            "items": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            },
            "type": "array",
            "uniqueItems": true
          },
          "knowledge_cutoff": {
            "anyOf": [
              {
                "maxLength": 256,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "lifecycle_status": {
            "anyOf": [
              {
                "const": "preview",
                "type": "string"
              },
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "deprecated",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          },
          "manufacturer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_family": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_manufacturer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ModelManufacturerReference"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_types": {
            "items": {
              "$ref": "#/components/schemas/ModelType"
            },
            "maxItems": 5,
            "type": "array",
            "uniqueItems": true
          },
          "non_hierarchical_channel_references": {
            "items": {
              "$ref": "#/components/schemas/NonHierarchicalChannelReference"
            },
            "maxItems": 64,
            "type": "array",
            "uniqueItems": true
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "offerings": {
            "items": {
              "$ref": "#/components/schemas/OfferingSummary"
            },
            "type": "array"
          },
          "output_modalities": {
            "items": {
              "anyOf": [
                {
                  "const": "audio",
                  "type": "string"
                },
                {
                  "const": "embedding",
                  "type": "string"
                },
                {
                  "const": "embeddings",
                  "type": "string"
                },
                {
                  "const": "image",
                  "type": "string"
                },
                {
                  "const": "rerank",
                  "type": "string"
                },
                {
                  "const": "speech",
                  "type": "string"
                },
                {
                  "const": "text",
                  "type": "string"
                },
                {
                  "const": "transcription",
                  "type": "string"
                },
                {
                  "const": "video",
                  "type": "string"
                }
              ]
            },
            "type": "array",
            "uniqueItems": true
          },
          "release_date": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "slug": {
            "maxLength": 192,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "source_created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "version_label": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "canonical_name",
          "manufacturer_id",
          "model_family",
          "version_label",
          "lifecycle_status",
          "identity_status",
          "capabilities",
          "output_modalities",
          "model_types",
          "offering_count",
          "freshness",
          "model_manufacturer",
          "information_channels",
          "non_hierarchical_channel_references",
          "business_category_quote_overviews",
          "release_date",
          "identity_sources",
          "offerings",
          "channel_price_overviews"
        ],
        "type": "object"
      },
      "ModelDetailResponse": {
        "$id": "ModelDetailResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ModelDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "ModelIdentitySource": {
        "$id": "ModelIdentitySource",
        "additionalProperties": false,
        "properties": {
          "external_id": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "mapping_method": {
            "anyOf": [
              {
                "const": "exact_stable_id",
                "type": "string"
              },
              {
                "const": "manual_confirmation",
                "type": "string"
              }
            ]
          },
          "observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "source_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "source_url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "source_id",
          "source_slug",
          "source_url",
          "external_id",
          "mapping_method",
          "observed_at"
        ],
        "type": "object"
      },
      "ModelIdentityStatus": {
        "$id": "ModelIdentityStatus",
        "anyOf": [
          {
            "const": "provisional",
            "type": "string"
          },
          {
            "const": "verified",
            "type": "string"
          },
          {
            "const": "unresolved",
            "type": "string"
          },
          {
            "const": "disputed",
            "type": "string"
          }
        ]
      },
      "ModelInformationChannelReference": {
        "$id": "ModelInformationChannelReference",
        "additionalProperties": false,
        "properties": {
          "business_category": {
            "$ref": "#/components/schemas/BusinessCategorySummary"
          },
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "channel_provider_id",
          "business_category",
          "offering_count",
          "freshness"
        ],
        "type": "object"
      },
      "ModelListResponse": {
        "$id": "ModelListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/ModelSummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "ModelManufacturerListResponse": {
        "$id": "ModelManufacturerListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/ModelManufacturerSummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "ModelManufacturerReference": {
        "$id": "ModelManufacturerReference",
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "status"
        ],
        "type": "object"
      },
      "ModelManufacturerSummary": {
        "$id": "ModelManufacturerSummary",
        "additionalProperties": false,
        "properties": {
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "model_count": {
            "minimum": 0,
            "type": "integer"
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "inactive",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "status",
          "model_count",
          "offering_count",
          "freshness"
        ],
        "type": "object"
      },
      "ModelSummary": {
        "$id": "ModelSummary",
        "additionalProperties": false,
        "properties": {
          "business_category_quote_overviews": {
            "items": {
              "$ref": "#/components/schemas/BusinessCategoryQuoteOverview"
            },
            "maxItems": 8,
            "type": "array"
          },
          "canonical_name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "capabilities": {
            "items": {
              "anyOf": [
                {
                  "const": "chat",
                  "type": "string"
                },
                {
                  "const": "reasoning",
                  "type": "string"
                },
                {
                  "const": "embedding",
                  "type": "string"
                },
                {
                  "const": "text_output",
                  "type": "string"
                },
                {
                  "const": "image_input",
                  "type": "string"
                },
                {
                  "const": "audio_input",
                  "type": "string"
                },
                {
                  "const": "video_input",
                  "type": "string"
                }
              ]
            },
            "type": "array",
            "uniqueItems": true
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "identity_status": {
            "$ref": "#/components/schemas/ModelIdentityStatus"
          },
          "information_channels": {
            "items": {
              "$ref": "#/components/schemas/ModelInformationChannelReference"
            },
            "maxItems": 64,
            "type": "array",
            "uniqueItems": true
          },
          "input_modalities": {
            "items": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            },
            "type": "array",
            "uniqueItems": true
          },
          "lifecycle_status": {
            "anyOf": [
              {
                "const": "preview",
                "type": "string"
              },
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "deprecated",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          },
          "manufacturer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_family": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_manufacturer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ModelManufacturerReference"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_types": {
            "items": {
              "$ref": "#/components/schemas/ModelType"
            },
            "maxItems": 5,
            "type": "array",
            "uniqueItems": true
          },
          "non_hierarchical_channel_references": {
            "items": {
              "$ref": "#/components/schemas/NonHierarchicalChannelReference"
            },
            "maxItems": 64,
            "type": "array",
            "uniqueItems": true
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "output_modalities": {
            "items": {
              "anyOf": [
                {
                  "const": "audio",
                  "type": "string"
                },
                {
                  "const": "embedding",
                  "type": "string"
                },
                {
                  "const": "embeddings",
                  "type": "string"
                },
                {
                  "const": "image",
                  "type": "string"
                },
                {
                  "const": "rerank",
                  "type": "string"
                },
                {
                  "const": "speech",
                  "type": "string"
                },
                {
                  "const": "text",
                  "type": "string"
                },
                {
                  "const": "transcription",
                  "type": "string"
                },
                {
                  "const": "video",
                  "type": "string"
                }
              ]
            },
            "type": "array",
            "uniqueItems": true
          },
          "slug": {
            "maxLength": 192,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "version_label": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "slug",
          "canonical_name",
          "manufacturer_id",
          "model_family",
          "version_label",
          "lifecycle_status",
          "identity_status",
          "capabilities",
          "output_modalities",
          "model_types",
          "offering_count",
          "freshness",
          "model_manufacturer",
          "information_channels",
          "non_hierarchical_channel_references",
          "business_category_quote_overviews"
        ],
        "type": "object"
      },
      "ModelType": {
        "$id": "ModelType",
        "anyOf": [
          {
            "const": "text",
            "type": "string"
          },
          {
            "const": "embedding",
            "type": "string"
          },
          {
            "const": "image",
            "type": "string"
          },
          {
            "const": "audio",
            "type": "string"
          },
          {
            "const": "video",
            "type": "string"
          }
        ]
      },
      "NonHierarchicalChannelReference": {
        "$id": "NonHierarchicalChannelReference",
        "additionalProperties": false,
        "properties": {
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "current_price_component_count": {
            "minimum": 0,
            "type": "integer"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "last_observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "reason": {
            "anyOf": [
              {
                "const": "discovery_only",
                "type": "string"
              },
              {
                "const": "manufacturer_unresolved",
                "type": "string"
              },
              {
                "const": "scope_unreviewed",
                "type": "string"
              }
            ]
          },
          "slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "channel_provider_id",
          "reason",
          "offering_count",
          "current_price_component_count",
          "freshness",
          "last_observed_at",
          "last_verified_at"
        ],
        "type": "object"
      },
      "NotReadyResponse": {
        "$id": "NotReadyResponse",
        "additionalProperties": false,
        "properties": {
          "checks": {
            "$ref": "#/components/schemas/ReadinessChecks"
          },
          "error_code": {
            "anyOf": [
              {
                "const": "DATABASE_UNAVAILABLE",
                "type": "string"
              },
              {
                "const": "SCHEMA_INCOMPATIBLE",
                "type": "string"
              },
              {
                "const": "READ_CAPABILITY_UNAVAILABLE",
                "type": "string"
              }
            ]
          },
          "request_id": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "const": "not_ready",
            "type": "string"
          }
        },
        "required": [
          "status",
          "checks",
          "error_code",
          "request_id"
        ],
        "type": "object"
      },
      "OfferingDetail": {
        "$id": "OfferingDetail",
        "properties": {
          "channel_model_id": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "context_window_tokens": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "display_name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "information_channel_id": {
            "format": "uuid",
            "type": "string"
          },
          "last_observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "last_verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "manufacturer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "market_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MarketScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "max_output_tokens": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "prices": {
            "items": {
              "$ref": "#/components/schemas/PriceReference"
            },
            "type": "array"
          },
          "pricing_status": {
            "anyOf": [
              {
                "const": "available",
                "type": "string"
              },
              {
                "const": "no_supported_price",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              }
            ]
          },
          "pricing_status_reason": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "region": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "route_type": {
            "anyOf": [
              {
                "const": "official_direct",
                "type": "string"
              },
              {
                "const": "cloud_hosted",
                "type": "string"
              },
              {
                "const": "routed",
                "type": "string"
              },
              {
                "const": "self_hosted",
                "type": "string"
              }
            ]
          },
          "service_tier": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "candidate",
                "type": "string"
              },
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "stale",
                "type": "string"
              },
              {
                "const": "disputed",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              },
              {
                "const": "deprecated",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "information_channel_id",
          "channel_provider_id",
          "manufacturer_id",
          "model_id",
          "channel_model_id",
          "display_name",
          "route_type",
          "region",
          "market_scope",
          "currency",
          "service_tier",
          "context_window_tokens",
          "max_output_tokens",
          "status",
          "freshness",
          "last_observed_at",
          "last_verified_at",
          "prices"
        ],
        "type": "object"
      },
      "OfferingDetailResponse": {
        "$id": "OfferingDetailResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "$ref": "#/components/schemas/OfferingDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "type": "object"
      },
      "OfferingListResponse": {
        "$id": "OfferingListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/OfferingSummary"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "OfferingSummary": {
        "$id": "OfferingSummary",
        "additionalProperties": false,
        "properties": {
          "channel_model_id": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "context_window_tokens": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "display_name": {
            "maxLength": 256,
            "minLength": 1,
            "type": "string"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "information_channel_id": {
            "format": "uuid",
            "type": "string"
          },
          "last_observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "last_verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "manufacturer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "market_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MarketScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "max_output_tokens": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "pricing_status": {
            "anyOf": [
              {
                "const": "available",
                "type": "string"
              },
              {
                "const": "no_supported_price",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              }
            ]
          },
          "pricing_status_reason": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "region": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "route_type": {
            "anyOf": [
              {
                "const": "official_direct",
                "type": "string"
              },
              {
                "const": "cloud_hosted",
                "type": "string"
              },
              {
                "const": "routed",
                "type": "string"
              },
              {
                "const": "self_hosted",
                "type": "string"
              }
            ]
          },
          "service_tier": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "const": "candidate",
                "type": "string"
              },
              {
                "const": "active",
                "type": "string"
              },
              {
                "const": "stale",
                "type": "string"
              },
              {
                "const": "disputed",
                "type": "string"
              },
              {
                "const": "unresolved",
                "type": "string"
              },
              {
                "const": "deprecated",
                "type": "string"
              },
              {
                "const": "retired",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "id",
          "information_channel_id",
          "channel_provider_id",
          "manufacturer_id",
          "model_id",
          "channel_model_id",
          "display_name",
          "route_type",
          "region",
          "market_scope",
          "currency",
          "service_tier",
          "context_window_tokens",
          "max_output_tokens",
          "status",
          "freshness",
          "last_observed_at",
          "last_verified_at"
        ],
        "type": "object"
      },
      "OfficialPriceCoverageSummary": {
        "$id": "OfficialPriceCoverageSummary",
        "additionalProperties": false,
        "properties": {
          "assessed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "assessment_completed_count": {
            "minimum": 0,
            "type": "integer"
          },
          "blocked_count": {
            "minimum": 0,
            "type": "integer"
          },
          "blocking_count": {
            "minimum": 0,
            "type": "integer"
          },
          "classification_unresolved_count": {
            "minimum": 0,
            "type": "integer"
          },
          "credential_required_count": {
            "minimum": 0,
            "type": "integer"
          },
          "discovered_entry_count": {
            "minimum": 0,
            "type": "integer"
          },
          "distinct_assessed_model_count": {
            "minimum": 0,
            "type": "integer"
          },
          "eligible_model_count": {
            "minimum": 0,
            "type": "integer"
          },
          "identity_unresolved_count": {
            "minimum": 0,
            "type": "integer"
          },
          "manual_only_count": {
            "minimum": 0,
            "type": "integer"
          },
          "no_public_official_price_count": {
            "minimum": 0,
            "type": "integer"
          },
          "non_model_routing_product_count": {
            "minimum": 0,
            "type": "integer"
          },
          "official_quote_exists_count": {
            "minimum": 0,
            "type": "integer"
          },
          "openrouter_snapshot_at": {
            "format": "date-time",
            "type": "string"
          },
          "openrouter_snapshot_hash": {
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "openrouter_snapshot_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_unresolved_count": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "openrouter_snapshot_id",
          "openrouter_snapshot_hash",
          "openrouter_snapshot_at",
          "discovered_entry_count",
          "eligible_model_count",
          "non_model_routing_product_count",
          "classification_unresolved_count",
          "assessment_completed_count",
          "distinct_assessed_model_count",
          "official_quote_exists_count",
          "no_public_official_price_count",
          "credential_required_count",
          "manual_only_count",
          "blocked_count",
          "identity_unresolved_count",
          "source_unresolved_count",
          "blocking_count",
          "assessed_at"
        ],
        "type": "object"
      },
      "PriceChange": {
        "$id": "PriceChange",
        "additionalProperties": false,
        "properties": {
          "changed_at": {
            "format": "date-time",
            "type": "string"
          },
          "changed_fields": {
            "items": {
              "anyOf": [
                {
                  "const": "amount",
                  "type": "string"
                },
                {
                  "const": "currency",
                  "type": "string"
                },
                {
                  "const": "quantity",
                  "type": "string"
                },
                {
                  "const": "unit",
                  "type": "string"
                },
                {
                  "const": "conditions",
                  "type": "string"
                }
              ]
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "current": {
            "$ref": "#/components/schemas/PriceReference"
          },
          "previous": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PriceReference"
              },
              {
                "type": "null"
              }
            ]
          },
          "rate_component_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "rate_component_id",
          "changed_at",
          "previous",
          "current",
          "changed_fields"
        ],
        "type": "object"
      },
      "PriceChangeListResponse": {
        "$id": "PriceChangeListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/PriceChange"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "PriceListResponse": {
        "$id": "PriceListResponse",
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/PriceReference"
            },
            "type": "array"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "page": {
            "$ref": "#/components/schemas/CursorPage"
          }
        },
        "required": [
          "data",
          "page",
          "meta"
        ],
        "type": "object"
      },
      "PriceReference": {
        "$id": "PriceReference",
        "additionalProperties": false,
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/DecimalString"
          },
          "billing_dimension": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[a-z0-9_]+$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "component_key": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9_]+$",
            "type": "string"
          },
          "component_type": {
            "maxLength": 64,
            "minLength": 1,
            "pattern": "^[a-z0-9_]+$",
            "type": "string"
          },
          "conditions": {
            "items": {
              "$ref": "#/components/schemas/RateCondition"
            },
            "maxItems": 32,
            "type": "array"
          },
          "currency": {
            "$ref": "#/components/schemas/CurrencyCode"
          },
          "is_default_market": {
            "type": "boolean"
          },
          "market_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MarketScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "offering_id": {
            "format": "uuid",
            "type": "string"
          },
          "price_version_id": {
            "format": "uuid",
            "type": "string"
          },
          "provenance": {
            "$ref": "#/components/schemas/Provenance"
          },
          "quantity": {
            "minimum": 1,
            "type": "integer"
          },
          "rate_component_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_region": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "unit": {
            "$ref": "#/components/schemas/BillingUnit"
          },
          "usd_standard": {
            "additionalProperties": false,
            "properties": {
              "amount": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/DecimalString"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "conversion_method": {
                "anyOf": [
                  {
                    "const": "identity",
                    "type": "string"
                  },
                  {
                    "const": "ecb_reference",
                    "type": "string"
                  },
                  {
                    "const": "unavailable",
                    "type": "string"
                  }
                ]
              },
              "display_amount": {
                "anyOf": [
                  {
                    "pattern": "^(?:<\\$0\\.0001|\\$(?:0|[1-9][0-9]*)\\.[0-9]{4})$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "observed_at": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "reference_date": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_slug": {
                "anyOf": [
                  {
                    "maxLength": 128,
                    "minLength": 1,
                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_url": {
                "anyOf": [
                  {
                    "format": "uri",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "const": "identity",
                    "type": "string"
                  },
                  {
                    "const": "fresh",
                    "type": "string"
                  },
                  {
                    "const": "aging",
                    "type": "string"
                  },
                  {
                    "const": "stale",
                    "type": "string"
                  },
                  {
                    "const": "unavailable",
                    "type": "string"
                  }
                ]
              }
            },
            "required": [
              "status",
              "conversion_method",
              "amount",
              "display_amount",
              "reference_date",
              "source_slug",
              "source_url",
              "observed_at"
            ],
            "type": "object"
          },
          "valid_from": {
            "format": "date-time",
            "type": "string"
          },
          "valid_to": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "price_version_id",
          "offering_id",
          "rate_component_id",
          "component_type",
          "component_key",
          "billing_dimension",
          "amount",
          "currency",
          "quantity",
          "unit",
          "conditions",
          "source_region",
          "market_scope",
          "is_default_market",
          "usd_standard",
          "valid_from",
          "valid_to",
          "provenance"
        ],
        "type": "object"
      },
      "Provenance": {
        "$id": "Provenance",
        "additionalProperties": false,
        "properties": {
          "authority_tier": {
            "anyOf": [
              {
                "const": "official",
                "type": "string"
              },
              {
                "const": "channel_structured",
                "type": "string"
              },
              {
                "const": "trusted_aggregate",
                "type": "string"
              },
              {
                "const": "other_public",
                "type": "string"
              },
              {
                "const": "unverified",
                "type": "string"
              }
            ]
          },
          "extraction_attempt_id": {
            "format": "uuid",
            "type": "string"
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "ingestion_run_id": {
            "format": "uuid",
            "type": "string"
          },
          "normalized_snapshot_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "snapshot_hash": {
            "anyOf": [
              {
                "pattern": "^[0-9a-f]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_check_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_observation_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "source_url": {
            "format": "uri",
            "type": "string"
          },
          "verification_status": {
            "$ref": "#/components/schemas/VerificationStatus"
          },
          "verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "source_id",
          "source_url",
          "authority_tier",
          "observed_at",
          "verified_at",
          "verification_status",
          "freshness"
        ],
        "type": "object"
      },
      "QuotePriceReference": {
        "$id": "QuotePriceReference",
        "additionalProperties": false,
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/DecimalString"
          },
          "billing_dimension": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[a-z0-9_]+$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "component_type": {
            "maxLength": 64,
            "minLength": 1,
            "pattern": "^[a-z0-9_]+$",
            "type": "string"
          },
          "conditions": {
            "items": {
              "$ref": "#/components/schemas/RateCondition"
            },
            "maxItems": 32,
            "type": "array"
          },
          "currency": {
            "$ref": "#/components/schemas/CurrencyCode"
          },
          "price_version_id": {
            "format": "uuid",
            "type": "string"
          },
          "provenance": {
            "$ref": "#/components/schemas/QuoteProvenance"
          },
          "quantity": {
            "minimum": 1,
            "type": "integer"
          },
          "source_region": {
            "maxLength": 128,
            "minLength": 1,
            "type": "string"
          },
          "unit": {
            "$ref": "#/components/schemas/BillingUnit"
          },
          "usd_standard": {
            "additionalProperties": false,
            "properties": {
              "amount": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/DecimalString"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "conversion_method": {
                "anyOf": [
                  {
                    "const": "identity",
                    "type": "string"
                  },
                  {
                    "const": "ecb_reference",
                    "type": "string"
                  },
                  {
                    "const": "unavailable",
                    "type": "string"
                  }
                ]
              },
              "display_amount": {
                "anyOf": [
                  {
                    "pattern": "^(?:<\\$0\\.0001|\\$(?:0|[1-9][0-9]*)\\.[0-9]{4})$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "observed_at": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "reference_date": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_url": {
                "anyOf": [
                  {
                    "format": "uri",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "const": "identity",
                    "type": "string"
                  },
                  {
                    "const": "fresh",
                    "type": "string"
                  },
                  {
                    "const": "aging",
                    "type": "string"
                  },
                  {
                    "const": "stale",
                    "type": "string"
                  },
                  {
                    "const": "unavailable",
                    "type": "string"
                  }
                ]
              }
            },
            "required": [
              "status",
              "conversion_method",
              "amount",
              "display_amount",
              "reference_date",
              "source_url",
              "observed_at"
            ],
            "type": "object"
          }
        },
        "required": [
          "price_version_id",
          "component_type",
          "billing_dimension",
          "amount",
          "currency",
          "quantity",
          "unit",
          "conditions",
          "source_region",
          "usd_standard",
          "provenance"
        ],
        "type": "object"
      },
      "QuoteProvenance": {
        "$id": "QuoteProvenance",
        "additionalProperties": false,
        "properties": {
          "authority_tier": {
            "anyOf": [
              {
                "const": "official",
                "type": "string"
              },
              {
                "const": "channel_structured",
                "type": "string"
              },
              {
                "const": "trusted_aggregate",
                "type": "string"
              },
              {
                "const": "other_public",
                "type": "string"
              },
              {
                "const": "unverified",
                "type": "string"
              }
            ]
          },
          "freshness": {
            "$ref": "#/components/schemas/FreshnessState"
          },
          "observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "source_url": {
            "format": "uri",
            "type": "string"
          },
          "verification_status": {
            "$ref": "#/components/schemas/VerificationStatus"
          },
          "verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "source_url",
          "authority_tier",
          "observed_at",
          "verified_at",
          "verification_status",
          "freshness"
        ],
        "type": "object"
      },
      "QuoteRateComponent": {
        "$id": "QuoteRateComponent",
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "display_rate": {
                "additionalProperties": false,
                "properties": {
                  "amount": {
                    "$ref": "#/components/schemas/DecimalString"
                  },
                  "currency": {
                    "$ref": "#/components/schemas/CurrencyCode"
                  },
                  "formatted_usd_amount": {
                    "anyOf": [
                      {
                        "pattern": "^(?:<\\$0\\.0001|\\$(?:0|[1-9][0-9]*)\\.[0-9]{4})$",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "is_usd_reference": {
                    "type": "boolean"
                  },
                  "quantity": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "unit": {
                    "$ref": "#/components/schemas/BillingUnit"
                  }
                },
                "required": [
                  "amount",
                  "currency",
                  "quantity",
                  "unit",
                  "is_usd_reference",
                  "formatted_usd_amount"
                ],
                "type": "object"
              },
              "label": {
                "maxLength": 256,
                "minLength": 1,
                "type": "string"
              },
              "source_price": {
                "$ref": "#/components/schemas/QuotePriceReference"
              },
              "status": {
                "const": "available",
                "type": "string"
              }
            },
            "required": [
              "status",
              "label",
              "display_rate",
              "source_price"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "component_type": {
                "anyOf": [
                  {
                    "maxLength": 64,
                    "minLength": 1,
                    "pattern": "^[a-z0-9_]+$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "reason": {
                "anyOf": [
                  {
                    "const": "missing_rate",
                    "type": "string"
                  },
                  {
                    "const": "multiple_tiers",
                    "type": "string"
                  },
                  {
                    "const": "offering_ambiguous",
                    "type": "string"
                  },
                  {
                    "const": "offering_missing",
                    "type": "string"
                  },
                  {
                    "const": "historical_only",
                    "type": "string"
                  },
                  {
                    "const": "baseline_missing",
                    "type": "string"
                  },
                  {
                    "const": "scope_unreviewed",
                    "type": "string"
                  },
                  {
                    "const": "manufacturer_unresolved",
                    "type": "string"
                  },
                  {
                    "const": "conditions_incomplete",
                    "type": "string"
                  },
                  {
                    "const": "component_missing",
                    "type": "string"
                  },
                  {
                    "const": "disputed",
                    "type": "string"
                  },
                  {
                    "const": "aging",
                    "type": "string"
                  },
                  {
                    "const": "stale",
                    "type": "string"
                  }
                ]
              },
              "status": {
                "const": "unavailable",
                "type": "string"
              }
            },
            "required": [
              "status",
              "component_type",
              "reason"
            ],
            "type": "object"
          }
        ]
      },
      "RateCondition": {
        "$id": "RateCondition",
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "maximum": {
                "minimum": 0,
                "type": "integer"
              },
              "minimum": {
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "const": "context_tokens",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "maximum": {
                "minimum": 0,
                "type": "integer"
              },
              "minimum": {
                "minimum": 0,
                "type": "integer"
              },
              "type": {
                "const": "monthly_volume",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "duration_seconds": {
                "minimum": 1,
                "type": "integer"
              },
              "operation": {
                "anyOf": [
                  {
                    "const": "read",
                    "type": "string"
                  },
                  {
                    "const": "write",
                    "type": "string"
                  },
                  {
                    "const": "miss",
                    "type": "string"
                  }
                ]
              },
              "type": {
                "const": "cache",
                "type": "string"
              }
            },
            "required": [
              "type",
              "operation"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "eligible": {
                "type": "boolean"
              },
              "type": {
                "const": "batch",
                "type": "string"
              }
            },
            "required": [
              "type",
              "eligible"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "type": {
                "const": "service_tier",
                "type": "string"
              },
              "value": {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "type",
              "value"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "type": {
                "const": "region",
                "type": "string"
              },
              "value": {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "type",
              "value"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "type": {
                "const": "modality",
                "type": "string"
              },
              "value": {
                "anyOf": [
                  {
                    "const": "prompt",
                    "type": "string"
                  },
                  {
                    "const": "completion",
                    "type": "string"
                  },
                  {
                    "const": "embedding",
                    "type": "string"
                  },
                  {
                    "const": "rerank",
                    "type": "string"
                  }
                ]
              }
            },
            "required": [
              "type",
              "value"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "key": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[a-z0-9_]+$",
                "type": "string"
              },
              "type": {
                "const": "channel_qualifier",
                "type": "string"
              },
              "value": {
                "maxLength": 256,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "type",
              "key",
              "value"
            ],
            "type": "object"
          }
        ]
      },
      "ReadinessChecks": {
        "$id": "ReadinessChecks",
        "additionalProperties": false,
        "properties": {
          "configuration": {
            "anyOf": [
              {
                "const": "ok",
                "type": "string"
              },
              {
                "const": "failed",
                "type": "string"
              }
            ]
          },
          "database": {
            "anyOf": [
              {
                "const": "ok",
                "type": "string"
              },
              {
                "const": "failed",
                "type": "string"
              }
            ]
          },
          "read_capability": {
            "anyOf": [
              {
                "const": "ok",
                "type": "string"
              },
              {
                "const": "unavailable",
                "type": "string"
              }
            ]
          },
          "schema": {
            "anyOf": [
              {
                "const": "ok",
                "type": "string"
              },
              {
                "const": "incompatible",
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "configuration",
          "database",
          "read_capability",
          "schema"
        ],
        "type": "object"
      },
      "ReadyResponse": {
        "$id": "ReadyResponse",
        "additionalProperties": false,
        "properties": {
          "checks": {
            "$ref": "#/components/schemas/ReadinessChecks"
          },
          "status": {
            "const": "ready",
            "type": "string"
          }
        },
        "required": [
          "status",
          "checks"
        ],
        "type": "object"
      },
      "ResponseMeta": {
        "$id": "ResponseMeta",
        "additionalProperties": false,
        "properties": {
          "catalog_epoch": {
            "pattern": "^(?:0|[1-9][0-9]*)$",
            "type": "string"
          },
          "observed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "snapshot_at": {
            "format": "date-time",
            "type": "string"
          },
          "verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "catalog_epoch",
          "snapshot_at",
          "observed_at",
          "verified_at"
        ],
        "type": "object"
      },
      "SignedDecimalString": {
        "$id": "SignedDecimalString",
        "pattern": "^-?(?:0|[1-9][0-9]{0,19})(?:\\.[0-9]{1,18})?$",
        "type": "string"
      },
      "SourceCoverage": {
        "$id": "SourceCoverage",
        "additionalProperties": false,
        "properties": {
          "disputed_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "in_scope_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "mapped_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "out_of_scope_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "published_price_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "source_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          },
          "source_url": {
            "format": "uri",
            "type": "string"
          },
          "unresolved_channel_provider_count": {
            "minimum": 0,
            "type": "integer"
          },
          "unresolved_model_count": {
            "minimum": 0,
            "type": "integer"
          },
          "unresolved_model_manufacturer_count": {
            "minimum": 0,
            "type": "integer"
          },
          "unresolved_offering_count": {
            "minimum": 0,
            "type": "integer"
          },
          "without_price_offering_count": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "source_id",
          "source_slug",
          "source_url",
          "observed_at",
          "in_scope_offering_count",
          "mapped_offering_count",
          "published_price_offering_count",
          "unresolved_model_manufacturer_count",
          "unresolved_channel_provider_count",
          "unresolved_model_count",
          "unresolved_offering_count",
          "without_price_offering_count",
          "out_of_scope_offering_count",
          "disputed_offering_count"
        ],
        "type": "object"
      },
      "SourceStatus": {
        "$id": "SourceStatus",
        "additionalProperties": false,
        "properties": {
          "authority_tier": {
            "anyOf": [
              {
                "const": "official",
                "type": "string"
              },
              {
                "const": "channel_structured",
                "type": "string"
              },
              {
                "const": "trusted_aggregate",
                "type": "string"
              },
              {
                "const": "other_public",
                "type": "string"
              },
              {
                "const": "unverified",
                "type": "string"
              }
            ]
          },
          "channel_provider_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "coverage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SourceCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "decision_state": {
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "endpoint_url": {
            "format": "uri",
            "type": "string"
          },
          "information_channel_id": {
            "format": "uuid",
            "type": "string"
          },
          "last_check_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_check_status": {
            "anyOf": [
              {
                "maxLength": 64,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_successful_sync_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_run_error_code": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_run_finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_run_status": {
            "anyOf": [
              {
                "const": "queued",
                "type": "string"
              },
              {
                "const": "running",
                "type": "string"
              },
              {
                "const": "succeeded",
                "type": "string"
              },
              {
                "const": "partial",
                "type": "string"
              },
              {
                "const": "failed",
                "type": "string"
              },
              {
                "const": "cancelled",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "manufacturer_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "query_mode": {
            "anyOf": [
              {
                "const": "api",
                "type": "string"
              },
              {
                "const": "structured_document",
                "type": "string"
              },
              {
                "const": "static_html",
                "type": "string"
              },
              {
                "const": "rendered_html",
                "type": "string"
              },
              {
                "const": "pdf",
                "type": "string"
              },
              {
                "const": "official_repository",
                "type": "string"
              },
              {
                "const": "manual",
                "type": "string"
              }
            ]
          },
          "snapshot_hash": {
            "anyOf": [
              {
                "pattern": "^[0-9a-f]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_id": {
            "format": "uuid",
            "type": "string"
          },
          "source_slug": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "type": "string"
          }
        },
        "required": [
          "source_id",
          "source_slug",
          "authority_tier",
          "information_channel_id",
          "channel_provider_id",
          "manufacturer_id",
          "query_mode",
          "decision_state",
          "enabled",
          "endpoint_url",
          "last_successful_sync_at",
          "last_check_at",
          "last_check_status",
          "snapshot_hash",
          "latest_run_status",
          "latest_run_error_code",
          "latest_run_finished_at",
          "coverage"
        ],
        "type": "object"
      },
      "VerificationStatus": {
        "$id": "VerificationStatus",
        "anyOf": [
          {
            "const": "provisional",
            "type": "string"
          },
          {
            "const": "verified",
            "type": "string"
          },
          {
            "const": "disputed",
            "type": "string"
          },
          {
            "const": "unresolved",
            "type": "string"
          },
          {
            "const": "withdrawn",
            "type": "string"
          }
        ]
      }
    }
  },
  "info": {
    "description": "Source-backed model, offering, conditional price, and provenance contracts.",
    "title": "TokenRadar public API",
    "version": "1.0.0"
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "openapi": "3.1.0",
  "paths": {
    "/business-categories": {
      "get": {
        "description": "List the reviewed business categories that partition public quote channels.",
        "operationId": "listBusinessCategories",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "name",
                  "type": "string"
                },
                {
                  "const": "slug",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "active",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "active",
                  "type": "string"
                },
                {
                  "const": "inactive",
                  "type": "string"
                },
                {
                  "const": "retired",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "id": "00000000-0000-7000-8000-000000000001",
                      "name": "example",
                      "slug": "example",
                      "status": "active"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "BusinessCategoryListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/BusinessCategorySummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List public business categories",
        "tags": [
          "Business categories"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/catalog-facets": {
      "get": {
        "description": "Return selectable channels, manufacturers, and output categories for one fixed catalog epoch.",
        "operationId": "getCatalogFacets",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "business_categories": [
                      {
                        "business_category": {
                          "id": "00000000-0000-7000-8000-000000000001",
                          "name": "example",
                          "slug": "example",
                          "status": "active"
                        },
                        "matching_model_count": 1
                      }
                    ],
                    "information_channels": [
                      {
                        "information_channel": {
                          "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                          "channel_totals": {
                            "current_price_component_count": 0,
                            "freshness": "fresh",
                            "historical_price_version_count": 0,
                            "last_observed_at": "2026-07-30T00:00:00Z",
                            "last_verified_at": "2026-07-30T00:00:00Z",
                            "offering_count": 0
                          },
                          "id": "00000000-0000-7000-8000-000000000001",
                          "market_scopes": [
                            "mainland_cn"
                          ],
                          "name": "example",
                          "scopes": [
                            {
                              "business_category": {
                                "id": "00000000-0000-7000-8000-000000000001",
                                "name": "example",
                                "slug": "example",
                                "status": "active"
                              },
                              "id": "00000000-0000-7000-8000-000000000001",
                              "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                              "market_scopes": [
                                "mainland_cn"
                              ],
                              "relationship_status": "pending",
                              "reviewed_at": "2026-07-30T00:00:00Z"
                            }
                          ],
                          "slug": "example",
                          "status": "active"
                        },
                        "matching_model_count": 0
                      }
                    ],
                    "model_manufacturers": [
                      {
                        "matching_model_count": 1,
                        "model_manufacturer": {
                          "freshness": "fresh",
                          "id": "00000000-0000-7000-8000-000000000001",
                          "model_count": 0,
                          "name": "example",
                          "offering_count": 0,
                          "slug": "example",
                          "status": "active"
                        }
                      }
                    ],
                    "model_types": [
                      {
                        "matching_model_count": 0,
                        "model_type": "text"
                      }
                    ],
                    "total_count": 0
                  },
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "CatalogFacetsResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "business_categories": {
                          "items": {
                            "$ref": "#/components/schemas/CatalogFacetBusinessCategory"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "information_channels": {
                          "items": {
                            "$ref": "#/components/schemas/CatalogFacetChannel"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "model_manufacturers": {
                          "items": {
                            "$ref": "#/components/schemas/CatalogFacetManufacturer"
                          },
                          "maxItems": 256,
                          "type": "array"
                        },
                        "model_types": {
                          "items": {
                            "$ref": "#/components/schemas/CatalogFacetModelType"
                          },
                          "maxItems": 5,
                          "type": "array"
                        },
                        "total_count": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "business_categories",
                        "information_channels",
                        "model_manufacturers",
                        "model_types",
                        "total_count"
                      ],
                      "type": "object"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Return model-catalog business categories, channels, and output-category facets",
        "tags": [
          "Catalog"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/catalog-summary": {
      "get": {
        "description": "Return fixed-epoch catalog counts, source status, coverage, and the public M1 quality gate.",
        "operationId": "getCatalogSummary",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "catalog_epoch": "0",
                    "channel_provider_count": 0,
                    "coverage_denominator": 0,
                    "coverage_satisfied": 0,
                    "information_channel_count": 0,
                    "last_successful_sync_at": "2026-07-30T00:00:00Z",
                    "model_count": 0,
                    "model_manufacturer_count": 0,
                    "offering_count": 0,
                    "official_source_coverage": {
                      "assessed_at": "2026-07-30T00:00:00Z",
                      "assessment_completed_count": 0,
                      "blocked_count": 0,
                      "blocking_count": 0,
                      "classification_unresolved_count": 0,
                      "credential_required_count": 0,
                      "discovered_entry_count": 0,
                      "distinct_assessed_model_count": 0,
                      "eligible_model_count": 0,
                      "identity_unresolved_count": 0,
                      "manual_only_count": 0,
                      "no_public_official_price_count": 0,
                      "non_model_routing_product_count": 0,
                      "official_quote_exists_count": 0,
                      "openrouter_snapshot_at": "2026-07-30T00:00:00Z",
                      "openrouter_snapshot_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "openrouter_snapshot_id": "00000000-0000-7000-8000-000000000001",
                      "source_unresolved_count": 0
                    },
                    "quality_gate": {
                      "blocking_count": 0,
                      "catalog_epoch": "0",
                      "finding_counts": {},
                      "snapshot_at": "2026-07-30T00:00:00Z",
                      "status": "pass"
                    },
                    "source_coverage": {
                      "disputed_offering_count": 0,
                      "in_scope_offering_count": 0,
                      "mapped_offering_count": 0,
                      "observed_at": "2026-07-30T00:00:00Z",
                      "out_of_scope_offering_count": 0,
                      "published_price_offering_count": 0,
                      "source_id": "00000000-0000-7000-8000-000000000001",
                      "source_slug": "example",
                      "source_url": "https://api.tokenradar.example/api/v1",
                      "unresolved_channel_provider_count": 0,
                      "unresolved_model_count": 0,
                      "unresolved_model_manufacturer_count": 0,
                      "unresolved_offering_count": 0,
                      "without_price_offering_count": 0
                    }
                  },
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "CatalogSummaryResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "catalog_epoch": {
                          "pattern": "^(?:0|[1-9][0-9]*)$",
                          "type": "string"
                        },
                        "channel_provider_count": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "coverage_denominator": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "coverage_satisfied": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "information_channel_count": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "last_successful_sync_at": {
                          "anyOf": [
                            {
                              "format": "date-time",
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "model_count": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "model_manufacturer_count": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "offering_count": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "official_source_coverage": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/OfficialPriceCoverageSummary"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "quality_gate": {
                          "$ref": "#/components/schemas/CatalogQualityGate"
                        },
                        "source_coverage": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/SourceCoverage"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "source_statuses": {
                          "items": {
                            "$ref": "#/components/schemas/SourceStatus"
                          },
                          "maxItems": 64,
                          "type": "array"
                        }
                      },
                      "required": [
                        "model_manufacturer_count",
                        "channel_provider_count",
                        "information_channel_count",
                        "model_count",
                        "offering_count",
                        "coverage_satisfied",
                        "coverage_denominator",
                        "catalog_epoch",
                        "last_successful_sync_at",
                        "source_coverage",
                        "official_source_coverage",
                        "quality_gate"
                      ],
                      "type": "object"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Return an auditable catalog summary",
        "tags": [
          "Catalog"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/channel-providers": {
      "get": {
        "description": "List public commercial owners of concrete InformationChannels.",
        "operationId": "listChannelProviders",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "name",
                  "type": "string"
                },
                {
                  "const": "slug",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "active",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "active",
                  "type": "string"
                },
                {
                  "const": "inactive",
                  "type": "string"
                },
                {
                  "const": "retired",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "channel_count": 0,
                      "freshness": "fresh",
                      "id": "00000000-0000-7000-8000-000000000001",
                      "name": "example",
                      "offering_count": 0,
                      "slug": "example",
                      "status": "active"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "ChannelProviderListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/ChannelProviderSummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List public channel providers",
        "tags": [
          "Channel providers"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/exchange-rates": {
      "get": {
        "description": "Return one source-backed ECB reference exchange rate without changing original quote currencies.",
        "operationId": "getExchangeRate",
        "parameters": [
          {
            "example": "USD",
            "in": "query",
            "name": "base",
            "required": true,
            "schema": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            }
          },
          {
            "example": "USD",
            "in": "query",
            "name": "quote",
            "required": true,
            "schema": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            }
          },
          {
            "example": "latest",
            "in": "query",
            "name": "effective_at",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "latest",
                  "type": "string"
                },
                {
                  "format": "date",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "base_currency": "USD",
                    "freshness": "fresh",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "quote_currency": "USD",
                    "rate": "0",
                    "reference_date": "2026-07-30",
                    "source": {
                      "cny_source_slug": "example",
                      "cny_source_url": "https://api.tokenradar.example/api/v1",
                      "usd_source_slug": "example",
                      "usd_source_url": "https://api.tokenradar.example/api/v1"
                    }
                  },
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "ExchangeRateResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "base_currency": {
                          "pattern": "^[A-Z]{3}$",
                          "type": "string"
                        },
                        "freshness": {
                          "anyOf": [
                            {
                              "const": "fresh",
                              "type": "string"
                            },
                            {
                              "const": "aging",
                              "type": "string"
                            },
                            {
                              "const": "stale",
                              "type": "string"
                            }
                          ]
                        },
                        "observed_at": {
                          "format": "date-time",
                          "type": "string"
                        },
                        "quote_currency": {
                          "pattern": "^[A-Z]{3}$",
                          "type": "string"
                        },
                        "rate": {
                          "$ref": "#/components/schemas/DecimalString"
                        },
                        "reference_date": {
                          "format": "date",
                          "type": "string"
                        },
                        "source": {
                          "additionalProperties": false,
                          "properties": {
                            "cny_source_slug": {
                              "maxLength": 128,
                              "minLength": 1,
                              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                              "type": "string"
                            },
                            "cny_source_url": {
                              "format": "uri",
                              "type": "string"
                            },
                            "usd_source_slug": {
                              "maxLength": 128,
                              "minLength": 1,
                              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                              "type": "string"
                            },
                            "usd_source_url": {
                              "format": "uri",
                              "type": "string"
                            }
                          },
                          "required": [
                            "usd_source_slug",
                            "usd_source_url",
                            "cny_source_slug",
                            "cny_source_url"
                          ],
                          "type": "object"
                        }
                      },
                      "required": [
                        "base_currency",
                        "quote_currency",
                        "rate",
                        "reference_date",
                        "freshness",
                        "observed_at",
                        "source"
                      ],
                      "type": "object"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Get an ECB reference exchange rate",
        "tags": [
          "Reference data"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "exchange_rate_not_found",
            "description": "No public reference rate matches the request.",
            "status": 404
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/health": {
      "get": {
        "description": "Report process liveness without checking database or catalog dependencies.",
        "operationId": "getHealth",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "status": "ok"
                },
                "schema": {
                  "$id": "HealthResponse",
                  "additionalProperties": false,
                  "properties": {
                    "status": {
                      "const": "ok",
                      "type": "string"
                    }
                  },
                  "required": [
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          }
        },
        "summary": "Return process liveness",
        "tags": [
          "Operations"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "no_store",
        "x-tokenradar-database-role": "none",
        "x-tokenradar-rate-limit-group": "health",
        "x-tokenradar-stable-errors": []
      }
    },
    "/information-channel-hierarchy": {
      "get": {
        "description": "Return BusinessCategory, ModelManufacturer, and concrete InformationChannel relationships.",
        "operationId": "getInformationChannelHierarchy",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "id": "00000000-0000-7000-8000-000000000001",
                      "manufacturers": [
                        {
                          "id": "00000000-0000-7000-8000-000000000001",
                          "information_channels": [
                            {
                              "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                              "id": "00000000-0000-7000-8000-000000000001",
                              "market_scopes": [
                                "mainland_cn"
                              ],
                              "name": "example",
                              "scope_metrics": {
                                "current_price_component_count": 0,
                                "freshness": "fresh",
                                "historical_only_price_component_count": 0,
                                "historical_price_version_count": 0,
                                "last_observed_at": "2026-07-30T00:00:00Z",
                                "offering_count": 0,
                                "stability_status": "stable"
                              },
                              "slug": "example"
                            }
                          ],
                          "name": "example",
                          "slug": "example",
                          "status": "example"
                        }
                      ],
                      "name": "example",
                      "slug": "example",
                      "status": "active"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "InformationChannelHierarchyResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "id": {
                            "format": "uuid",
                            "type": "string"
                          },
                          "manufacturers": {
                            "items": {
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "format": "uuid",
                                  "type": "string"
                                },
                                "information_channels": {
                                  "items": {
                                    "additionalProperties": false,
                                    "properties": {
                                      "channel_provider_id": {
                                        "anyOf": [
                                          {
                                            "format": "uuid",
                                            "type": "string"
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "id": {
                                        "format": "uuid",
                                        "type": "string"
                                      },
                                      "market_scopes": {
                                        "items": {
                                          "$ref": "#/components/schemas/MarketScope"
                                        },
                                        "maxItems": 2,
                                        "type": "array",
                                        "uniqueItems": true
                                      },
                                      "name": {
                                        "maxLength": 256,
                                        "minLength": 1,
                                        "type": "string"
                                      },
                                      "scope_metrics": {
                                        "$ref": "#/components/schemas/InformationChannelScopeMetrics"
                                      },
                                      "slug": {
                                        "maxLength": 128,
                                        "minLength": 1,
                                        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "slug",
                                      "name",
                                      "channel_provider_id",
                                      "market_scopes",
                                      "scope_metrics"
                                    ],
                                    "type": "object"
                                  },
                                  "maxItems": 256,
                                  "type": "array"
                                },
                                "name": {
                                  "maxLength": 256,
                                  "minLength": 1,
                                  "type": "string"
                                },
                                "slug": {
                                  "maxLength": 128,
                                  "minLength": 1,
                                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                                  "type": "string"
                                },
                                "status": {
                                  "maxLength": 64,
                                  "minLength": 1,
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "slug",
                                "name",
                                "status",
                                "information_channels"
                              ],
                              "type": "object"
                            },
                            "maxItems": 1024,
                            "type": "array"
                          },
                          "name": {
                            "maxLength": 256,
                            "minLength": 1,
                            "type": "string"
                          },
                          "slug": {
                            "maxLength": 128,
                            "minLength": 1,
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                            "type": "string"
                          },
                          "status": {
                            "anyOf": [
                              {
                                "const": "active",
                                "type": "string"
                              },
                              {
                                "const": "inactive",
                                "type": "string"
                              },
                              {
                                "const": "retired",
                                "type": "string"
                              }
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "name",
                          "status",
                          "manufacturers"
                        ],
                        "type": "object"
                      },
                      "maxItems": 1024,
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Get the business category, manufacturer, and channel hierarchy",
        "tags": [
          "Information channels"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "hierarchy_unavailable",
            "description": "The reviewed channel hierarchy cannot be read.",
            "status": 503
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/information-channels": {
      "get": {
        "description": "List concrete public quote partitions with reviewed hierarchy and coverage metadata.",
        "operationId": "listInformationChannels",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "business_category",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "channel_provider",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "manufacturer",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "global",
            "in": "query",
            "name": "market_scope",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "global",
                  "type": "string"
                },
                {
                  "const": "mainland_cn",
                  "type": "string"
                },
                {
                  "const": "international",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "name",
                  "type": "string"
                },
                {
                  "const": "slug",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "active",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "active",
                  "type": "string"
                },
                {
                  "const": "inactive",
                  "type": "string"
                },
                {
                  "const": "retired",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                      "channel_totals": {
                        "current_price_component_count": 0,
                        "freshness": "fresh",
                        "historical_price_version_count": 0,
                        "last_observed_at": "2026-07-30T00:00:00Z",
                        "last_verified_at": "2026-07-30T00:00:00Z",
                        "offering_count": 0
                      },
                      "id": "00000000-0000-7000-8000-000000000001",
                      "market_scopes": [
                        "mainland_cn"
                      ],
                      "name": "example",
                      "scopes": [
                        {
                          "business_category": {
                            "id": "00000000-0000-7000-8000-000000000001",
                            "name": "example",
                            "slug": "example",
                            "status": "active"
                          },
                          "id": "00000000-0000-7000-8000-000000000001",
                          "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                          "market_scopes": [
                            "mainland_cn"
                          ],
                          "relationship_status": "pending",
                          "reviewed_at": "2026-07-30T00:00:00Z"
                        }
                      ],
                      "slug": "example",
                      "status": "active"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "InformationChannelListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/InformationChannelSummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List independent public price-information channels",
        "tags": [
          "Information channels"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/model-manufacturers": {
      "get": {
        "description": "List canonical model manufacturers represented in the public catalog.",
        "operationId": "listModelManufacturers",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "name",
                  "type": "string"
                },
                {
                  "const": "slug",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "active",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "active",
                  "type": "string"
                },
                {
                  "const": "inactive",
                  "type": "string"
                },
                {
                  "const": "retired",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "freshness": "fresh",
                      "id": "00000000-0000-7000-8000-000000000001",
                      "model_count": 0,
                      "name": "example",
                      "offering_count": 0,
                      "slug": "example",
                      "status": "active"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "ModelManufacturerListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/ModelManufacturerSummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List public model manufacturers",
        "tags": [
          "Model manufacturers"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/models": {
      "get": {
        "description": "List compact model summaries with bounded generic rate components and exact category, manufacturer, channel, and market filters. Components retain their actual unit, conditions, and evidence; missing components carry reasons. ID and name selectors for one dimension are mutually exclusive. region_key fails closed until a reviewed public projection exposes it.",
        "operationId": "listModels",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "capability",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "fresh",
            "in": "query",
            "name": "freshness",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "fresh",
                  "type": "string"
                },
                {
                  "const": "aging",
                  "type": "string"
                },
                {
                  "const": "stale",
                  "type": "string"
                },
                {
                  "const": "unresolved",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": false,
            "in": "query",
            "name": "has_channel_price",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "example": false,
            "in": "query",
            "name": "has_official_price",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "example": "provisional",
            "in": "query",
            "name": "identity_status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "provisional",
                  "type": "string"
                },
                {
                  "const": "verified",
                  "type": "string"
                },
                {
                  "const": "unresolved",
                  "type": "string"
                },
                {
                  "const": "disputed",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "lifecycle_status",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "business_category_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "business_category_name",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 256,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "model_manufacturer_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "model_manufacturer_name",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 256,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "information_channel_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "global"
            ],
            "in": "query",
            "name": "market_scope",
            "required": false,
            "schema": {
              "items": {
                "anyOf": [
                  {
                    "const": "global",
                    "type": "string"
                  },
                  {
                    "const": "international",
                    "type": "string"
                  },
                  {
                    "const": "mainland_cn",
                    "type": "string"
                  }
                ]
              },
              "maxItems": 3,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "region_key",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": "text",
            "in": "query",
            "name": "model_type",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/ModelType"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "canonical_name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "canonical_name",
                  "type": "string"
                },
                {
                  "const": "slug",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "business_category_quote_overviews": [
                        {
                          "business_category": {
                            "id": "00000000-0000-7000-8000-000000000001",
                            "name": "example",
                            "slug": "example",
                            "status": "active"
                          },
                          "components": [
                            {
                              "display_rate": {
                                "amount": "0",
                                "currency": "USD",
                                "formatted_usd_amount": "$0.0000",
                                "is_usd_reference": false,
                                "quantity": 1,
                                "unit": "tokens"
                              },
                              "label": "example",
                              "source_price": {
                                "amount": "0",
                                "billing_dimension": "example",
                                "component_type": "example",
                                "conditions": [
                                  {
                                    "type": "context_tokens"
                                  }
                                ],
                                "currency": "USD",
                                "price_version_id": "00000000-0000-7000-8000-000000000001",
                                "provenance": {
                                  "authority_tier": "official",
                                  "freshness": "fresh",
                                  "observed_at": "2026-07-30T00:00:00Z",
                                  "source_url": "https://api.tokenradar.example/api/v1",
                                  "verification_status": "provisional",
                                  "verified_at": "2026-07-30T00:00:00Z"
                                },
                                "quantity": 1,
                                "source_region": "example",
                                "unit": "tokens",
                                "usd_standard": {
                                  "amount": "0",
                                  "conversion_method": "identity",
                                  "display_amount": "$0.0000",
                                  "observed_at": "2026-07-30T00:00:00Z",
                                  "reference_date": "2026-07-30",
                                  "source_url": "https://api.tokenradar.example/api/v1",
                                  "status": "identity"
                                }
                              },
                              "status": "available"
                            }
                          ],
                          "freshness": "fresh",
                          "information_channel": {
                            "id": "00000000-0000-7000-8000-000000000001",
                            "name": "example",
                            "slug": "example"
                          },
                          "market_scope": "mainland_cn",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "offering_id": "00000000-0000-7000-8000-000000000001",
                          "provenance": {
                            "authority_tier": "official",
                            "freshness": "fresh",
                            "observed_at": "2026-07-30T00:00:00Z",
                            "source_url": "https://api.tokenradar.example/api/v1",
                            "verification_status": "provisional",
                            "verified_at": "2026-07-30T00:00:00Z"
                          },
                          "selection_reason": "unique_standard_offering",
                          "selection_status": "selected",
                          "tier_status": "standard",
                          "used_mainland_fallback": false,
                          "verification_status": "provisional"
                        }
                      ],
                      "canonical_name": "example",
                      "capabilities": [
                        "chat"
                      ],
                      "freshness": "fresh",
                      "id": "00000000-0000-7000-8000-000000000001",
                      "identity_status": "provisional",
                      "information_channels": [
                        {
                          "business_category": {
                            "id": "00000000-0000-7000-8000-000000000001",
                            "name": "example",
                            "slug": "example",
                            "status": "active"
                          },
                          "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                          "freshness": "fresh",
                          "id": "00000000-0000-7000-8000-000000000001",
                          "name": "example",
                          "offering_count": 0,
                          "slug": "example"
                        }
                      ],
                      "lifecycle_status": "preview",
                      "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                      "model_family": "example",
                      "model_manufacturer": {
                        "id": "00000000-0000-7000-8000-000000000001",
                        "name": "example",
                        "slug": "example",
                        "status": "active"
                      },
                      "model_types": [
                        "text"
                      ],
                      "non_hierarchical_channel_references": [
                        {
                          "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                          "current_price_component_count": 0,
                          "freshness": "fresh",
                          "id": "00000000-0000-7000-8000-000000000001",
                          "last_observed_at": "2026-07-30T00:00:00Z",
                          "last_verified_at": "2026-07-30T00:00:00Z",
                          "name": "example",
                          "offering_count": 0,
                          "reason": "discovery_only",
                          "slug": "example"
                        }
                      ],
                      "offering_count": 0,
                      "output_modalities": [
                        "audio"
                      ],
                      "slug": "example",
                      "version_label": "example"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "ModelListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/ModelSummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List public models",
        "tags": [
          "Models"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          },
          {
            "code": "filter_unavailable",
            "description": "A reviewed public projection does not yet expose the requested exact filter.",
            "status": 422
          }
        ]
      }
    },
    "/models/{id}": {
      "get": {
        "description": "Return one model with complete offerings, price components, conditions, bounded history, and provenance.",
        "operationId": "getModel",
        "parameters": [
          {
            "example": "example",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "business_category_quote_overviews": [
                      {
                        "business_category": {
                          "id": "00000000-0000-7000-8000-000000000001",
                          "name": "example",
                          "slug": "example",
                          "status": "active"
                        },
                        "components": [
                          {
                            "display_rate": {
                              "amount": "0",
                              "currency": "USD",
                              "formatted_usd_amount": "$0.0000",
                              "is_usd_reference": false,
                              "quantity": 1,
                              "unit": "tokens"
                            },
                            "label": "example",
                            "source_price": {
                              "amount": "0",
                              "billing_dimension": "example",
                              "component_type": "example",
                              "conditions": [
                                {
                                  "type": "context_tokens"
                                }
                              ],
                              "currency": "USD",
                              "price_version_id": "00000000-0000-7000-8000-000000000001",
                              "provenance": {
                                "authority_tier": "official",
                                "freshness": "fresh",
                                "observed_at": "2026-07-30T00:00:00Z",
                                "source_url": "https://api.tokenradar.example/api/v1",
                                "verification_status": "provisional",
                                "verified_at": "2026-07-30T00:00:00Z"
                              },
                              "quantity": 1,
                              "source_region": "example",
                              "unit": "tokens",
                              "usd_standard": {
                                "amount": "0",
                                "conversion_method": "identity",
                                "display_amount": "$0.0000",
                                "observed_at": "2026-07-30T00:00:00Z",
                                "reference_date": "2026-07-30",
                                "source_url": "https://api.tokenradar.example/api/v1",
                                "status": "identity"
                              }
                            },
                            "status": "available"
                          }
                        ],
                        "freshness": "fresh",
                        "information_channel": {
                          "id": "00000000-0000-7000-8000-000000000001",
                          "name": "example",
                          "slug": "example"
                        },
                        "market_scope": "mainland_cn",
                        "observed_at": "2026-07-30T00:00:00Z",
                        "offering_id": "00000000-0000-7000-8000-000000000001",
                        "provenance": {
                          "authority_tier": "official",
                          "freshness": "fresh",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "verification_status": "provisional",
                          "verified_at": "2026-07-30T00:00:00Z"
                        },
                        "selection_reason": "unique_standard_offering",
                        "selection_status": "selected",
                        "tier_status": "standard",
                        "used_mainland_fallback": false,
                        "verification_status": "provisional"
                      }
                    ],
                    "canonical_name": "example",
                    "capabilities": [
                      "chat"
                    ],
                    "channel_price_overviews": [
                      {
                        "components": [
                          {
                            "display_rate": {
                              "amount": "0",
                              "currency": "USD",
                              "formatted_usd_amount": "$0.0000",
                              "is_usd_reference": false,
                              "quantity": 1,
                              "unit": "tokens"
                            },
                            "label": "example",
                            "source_price": {
                              "amount": "0",
                              "billing_dimension": "example",
                              "component_type": "example",
                              "conditions": [
                                {
                                  "type": "context_tokens"
                                }
                              ],
                              "currency": "USD",
                              "price_version_id": "00000000-0000-7000-8000-000000000001",
                              "provenance": {
                                "authority_tier": "official",
                                "freshness": "fresh",
                                "observed_at": "2026-07-30T00:00:00Z",
                                "source_url": "https://api.tokenradar.example/api/v1",
                                "verification_status": "provisional",
                                "verified_at": "2026-07-30T00:00:00Z"
                              },
                              "quantity": 1,
                              "source_region": "example",
                              "unit": "tokens",
                              "usd_standard": {
                                "amount": "0",
                                "conversion_method": "identity",
                                "display_amount": "$0.0000",
                                "observed_at": "2026-07-30T00:00:00Z",
                                "reference_date": "2026-07-30",
                                "source_url": "https://api.tokenradar.example/api/v1",
                                "status": "identity"
                              }
                            },
                            "status": "available"
                          }
                        ],
                        "freshness": "fresh",
                        "information_channel": {
                          "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                          "channel_totals": {
                            "current_price_component_count": 0,
                            "freshness": "fresh",
                            "historical_price_version_count": 0,
                            "last_observed_at": "2026-07-30T00:00:00Z",
                            "last_verified_at": "2026-07-30T00:00:00Z",
                            "offering_count": 0
                          },
                          "id": "00000000-0000-7000-8000-000000000001",
                          "market_scopes": [
                            "mainland_cn"
                          ],
                          "name": "example",
                          "scopes": [
                            {
                              "business_category": {
                                "id": "00000000-0000-7000-8000-000000000001",
                                "name": "example",
                                "slug": "example",
                                "status": "active"
                              },
                              "id": "00000000-0000-7000-8000-000000000001",
                              "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                              "market_scopes": [
                                "mainland_cn"
                              ],
                              "relationship_status": "pending",
                              "reviewed_at": "2026-07-30T00:00:00Z"
                            }
                          ],
                          "slug": "example",
                          "status": "active"
                        },
                        "is_default_market": false,
                        "market_scope": "mainland_cn",
                        "observed_at": "2026-07-30T00:00:00Z",
                        "offering_count": 0,
                        "offering_id": "00000000-0000-7000-8000-000000000001",
                        "price_component_count": 0,
                        "scope": {
                          "business_category": {
                            "id": "00000000-0000-7000-8000-000000000001",
                            "name": "example",
                            "slug": "example",
                            "status": "active"
                          },
                          "id": "00000000-0000-7000-8000-000000000001",
                          "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                          "market_scopes": [
                            "mainland_cn"
                          ],
                          "relationship_status": "pending",
                          "reviewed_at": "2026-07-30T00:00:00Z"
                        },
                        "selection_reason": "unique_base_offering",
                        "selection_status": "selected",
                        "source": {
                          "authority_tier": "official",
                          "freshness": "fresh",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "verification_status": "provisional",
                          "verified_at": "2026-07-30T00:00:00Z"
                        },
                        "used_mainland_fallback": false,
                        "verification_status": "provisional"
                      }
                    ],
                    "freshness": "fresh",
                    "id": "00000000-0000-7000-8000-000000000001",
                    "identity_sources": [
                      {
                        "external_id": "example",
                        "mapping_method": "exact_stable_id",
                        "observed_at": "2026-07-30T00:00:00Z",
                        "source_id": "00000000-0000-7000-8000-000000000001",
                        "source_slug": "example",
                        "source_url": "https://api.tokenradar.example/api/v1"
                      }
                    ],
                    "identity_status": "provisional",
                    "information_channels": [
                      {
                        "business_category": {
                          "id": "00000000-0000-7000-8000-000000000001",
                          "name": "example",
                          "slug": "example",
                          "status": "active"
                        },
                        "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                        "freshness": "fresh",
                        "id": "00000000-0000-7000-8000-000000000001",
                        "name": "example",
                        "offering_count": 0,
                        "slug": "example"
                      }
                    ],
                    "lifecycle_status": "preview",
                    "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                    "model_family": "example",
                    "model_manufacturer": {
                      "id": "00000000-0000-7000-8000-000000000001",
                      "name": "example",
                      "slug": "example",
                      "status": "active"
                    },
                    "model_types": [
                      "text"
                    ],
                    "non_hierarchical_channel_references": [
                      {
                        "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                        "current_price_component_count": 0,
                        "freshness": "fresh",
                        "id": "00000000-0000-7000-8000-000000000001",
                        "last_observed_at": "2026-07-30T00:00:00Z",
                        "last_verified_at": "2026-07-30T00:00:00Z",
                        "name": "example",
                        "offering_count": 0,
                        "reason": "discovery_only",
                        "slug": "example"
                      }
                    ],
                    "offering_count": 0,
                    "offerings": [
                      {
                        "channel_model_id": "example",
                        "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                        "context_window_tokens": 1,
                        "currency": "USD",
                        "display_name": "example",
                        "freshness": "fresh",
                        "id": "00000000-0000-7000-8000-000000000001",
                        "information_channel_id": "00000000-0000-7000-8000-000000000001",
                        "last_observed_at": "2026-07-30T00:00:00Z",
                        "last_verified_at": "2026-07-30T00:00:00Z",
                        "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                        "market_scope": "mainland_cn",
                        "max_output_tokens": 1,
                        "model_id": "00000000-0000-7000-8000-000000000001",
                        "region": "example",
                        "route_type": "official_direct",
                        "service_tier": "example",
                        "status": "candidate"
                      }
                    ],
                    "output_modalities": [
                      "audio"
                    ],
                    "release_date": "2026-07-30",
                    "slug": "example",
                    "version_label": "example"
                  },
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "ModelDetailResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ModelDetail"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Return one public model",
        "tags": [
          "Models"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "model_not_found",
            "description": "The model is not present in the public catalog.",
            "status": 404
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/offers": {
      "get": {
        "description": "List concrete channel offerings with exact category, manufacturer, channel, and market filters while preserving route, tier, and currency. ID and name selectors for one dimension are mutually exclusive. region_key fails closed until a reviewed public projection exposes it.",
        "operationId": "listOffers",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "business_category_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "business_category_name",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 256,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": "USD",
            "in": "query",
            "name": "currency",
            "required": false,
            "schema": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "freshness",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "information_channel_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "global"
            ],
            "in": "query",
            "name": "market_scope",
            "required": false,
            "schema": {
              "items": {
                "anyOf": [
                  {
                    "const": "global",
                    "type": "string"
                  },
                  {
                    "const": "international",
                    "type": "string"
                  },
                  {
                    "const": "mainland_cn",
                    "type": "string"
                  }
                ]
              },
              "maxItems": 3,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "model",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": [
              "00000000-0000-7000-8000-000000000001"
            ],
            "in": "query",
            "name": "model_manufacturer_id",
            "required": false,
            "schema": {
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "model_manufacturer_name",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 256,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": [
              "example"
            ],
            "in": "query",
            "name": "region_key",
            "required": false,
            "schema": {
              "items": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "\\S",
                "type": "string"
              },
              "maxItems": 64,
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "route_type",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "service_tier",
            "required": false,
            "schema": {
              "maxLength": 128,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "display_name",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "display_name",
                  "type": "string"
                },
                {
                  "const": "id",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "provisional",
            "in": "query",
            "name": "verification_status",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/VerificationStatus"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "channel_model_id": "example",
                      "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                      "context_window_tokens": 1,
                      "currency": "USD",
                      "display_name": "example",
                      "freshness": "fresh",
                      "id": "00000000-0000-7000-8000-000000000001",
                      "information_channel_id": "00000000-0000-7000-8000-000000000001",
                      "last_observed_at": "2026-07-30T00:00:00Z",
                      "last_verified_at": "2026-07-30T00:00:00Z",
                      "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                      "market_scope": "mainland_cn",
                      "max_output_tokens": 1,
                      "model_id": "00000000-0000-7000-8000-000000000001",
                      "region": "example",
                      "route_type": "official_direct",
                      "service_tier": "example",
                      "status": "candidate"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "OfferingListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/OfferingSummary"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List public offers",
        "tags": [
          "Offers"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          },
          {
            "code": "filter_unavailable",
            "description": "A reviewed public projection does not yet expose the requested exact filter.",
            "status": 422
          }
        ]
      }
    },
    "/offers/{id}": {
      "get": {
        "description": "Return one concrete InformationChannel offering and all current conditional price components.",
        "operationId": "getOffer",
        "parameters": [
          {
            "example": "00000000-0000-7000-8000-000000000001",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "channel_model_id": "example",
                    "channel_provider_id": "00000000-0000-7000-8000-000000000001",
                    "context_window_tokens": 1,
                    "currency": "USD",
                    "display_name": "example",
                    "freshness": "fresh",
                    "id": "00000000-0000-7000-8000-000000000001",
                    "information_channel_id": "00000000-0000-7000-8000-000000000001",
                    "last_observed_at": "2026-07-30T00:00:00Z",
                    "last_verified_at": "2026-07-30T00:00:00Z",
                    "manufacturer_id": "00000000-0000-7000-8000-000000000001",
                    "market_scope": "mainland_cn",
                    "max_output_tokens": 1,
                    "model_id": "00000000-0000-7000-8000-000000000001",
                    "prices": [
                      {
                        "amount": "0",
                        "billing_dimension": "example",
                        "component_key": "example",
                        "component_type": "example",
                        "conditions": [
                          {
                            "type": "context_tokens"
                          }
                        ],
                        "currency": "USD",
                        "is_default_market": false,
                        "market_scope": "mainland_cn",
                        "offering_id": "00000000-0000-7000-8000-000000000001",
                        "price_version_id": "00000000-0000-7000-8000-000000000001",
                        "provenance": {
                          "authority_tier": "official",
                          "freshness": "fresh",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "source_id": "00000000-0000-7000-8000-000000000001",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "verification_status": "provisional",
                          "verified_at": "2026-07-30T00:00:00Z"
                        },
                        "quantity": 1,
                        "rate_component_id": "00000000-0000-7000-8000-000000000001",
                        "source_region": "example",
                        "unit": "tokens",
                        "usd_standard": {
                          "amount": "0",
                          "conversion_method": "identity",
                          "display_amount": "$0.0000",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "reference_date": "2026-07-30",
                          "source_slug": "example",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "status": "identity"
                        },
                        "valid_from": "2026-07-30T00:00:00Z",
                        "valid_to": "2026-07-30T00:00:00Z"
                      }
                    ],
                    "region": "example",
                    "route_type": "official_direct",
                    "service_tier": "example",
                    "status": "candidate"
                  },
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  }
                },
                "schema": {
                  "$id": "OfferingDetailResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OfferingDetail"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Return one public offer",
        "tags": [
          "Offers"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "offering_not_found",
            "description": "The offering is not present in the public catalog.",
            "status": 404
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/price-changes": {
      "get": {
        "description": "List source-backed change-only price transitions at a fixed catalog epoch.",
        "operationId": "listPriceChanges",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "component_type",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "USD",
            "in": "query",
            "name": "currency",
            "required": false,
            "schema": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "model",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "offering",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "information_channel",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "changed_at",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "changed_at",
                  "type": "string"
                },
                {
                  "const": "id",
                  "type": "string"
                }
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "changed_at": "2026-07-30T00:00:00Z",
                      "changed_fields": [
                        "amount"
                      ],
                      "current": {
                        "amount": "0",
                        "billing_dimension": "example",
                        "component_key": "example",
                        "component_type": "example",
                        "conditions": [
                          {
                            "type": "context_tokens"
                          }
                        ],
                        "currency": "USD",
                        "is_default_market": false,
                        "market_scope": "mainland_cn",
                        "offering_id": "00000000-0000-7000-8000-000000000001",
                        "price_version_id": "00000000-0000-7000-8000-000000000001",
                        "provenance": {
                          "authority_tier": "official",
                          "freshness": "fresh",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "source_id": "00000000-0000-7000-8000-000000000001",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "verification_status": "provisional",
                          "verified_at": "2026-07-30T00:00:00Z"
                        },
                        "quantity": 1,
                        "rate_component_id": "00000000-0000-7000-8000-000000000001",
                        "source_region": "example",
                        "unit": "tokens",
                        "usd_standard": {
                          "amount": "0",
                          "conversion_method": "identity",
                          "display_amount": "$0.0000",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "reference_date": "2026-07-30",
                          "source_slug": "example",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "status": "identity"
                        },
                        "valid_from": "2026-07-30T00:00:00Z",
                        "valid_to": "2026-07-30T00:00:00Z"
                      },
                      "previous": {
                        "amount": "0",
                        "billing_dimension": "example",
                        "component_key": "example",
                        "component_type": "example",
                        "conditions": [
                          {
                            "type": "context_tokens"
                          }
                        ],
                        "currency": "USD",
                        "is_default_market": false,
                        "market_scope": "mainland_cn",
                        "offering_id": "00000000-0000-7000-8000-000000000001",
                        "price_version_id": "00000000-0000-7000-8000-000000000001",
                        "provenance": {
                          "authority_tier": "official",
                          "freshness": "fresh",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "source_id": "00000000-0000-7000-8000-000000000001",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "verification_status": "provisional",
                          "verified_at": "2026-07-30T00:00:00Z"
                        },
                        "quantity": 1,
                        "rate_component_id": "00000000-0000-7000-8000-000000000001",
                        "source_region": "example",
                        "unit": "tokens",
                        "usd_standard": {
                          "amount": "0",
                          "conversion_method": "identity",
                          "display_amount": "$0.0000",
                          "observed_at": "2026-07-30T00:00:00Z",
                          "reference_date": "2026-07-30",
                          "source_slug": "example",
                          "source_url": "https://api.tokenradar.example/api/v1",
                          "status": "identity"
                        },
                        "valid_from": "2026-07-30T00:00:00Z",
                        "valid_to": "2026-07-30T00:00:00Z"
                      },
                      "rate_component_id": "00000000-0000-7000-8000-000000000001"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "PriceChangeListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/PriceChange"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List source-backed price changes",
        "tags": [
          "Prices"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/prices": {
      "get": {
        "description": "List component-level price versions with exact decimal amounts, conditions, validity, and provenance.",
        "operationId": "listPrices",
        "parameters": [
          {
            "example": "example",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": 50,
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "observed_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "asc",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "asc",
                  "type": "string"
                },
                {
                  "const": "desc",
                  "type": "string"
                }
              ],
              "default": "asc"
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "verified_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "component_type",
            "required": false,
            "schema": {
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "USD",
            "in": "query",
            "name": "currency",
            "required": false,
            "schema": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "model",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "offering",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "example",
            "in": "query",
            "name": "information_channel",
            "required": false,
            "schema": {
              "maxLength": 192,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "example": "valid_from",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "valid_from",
                  "type": "string"
                },
                {
                  "const": "id",
                  "type": "string"
                }
              ]
            }
          },
          {
            "example": "2026-07-30T00:00:00Z",
            "in": "query",
            "name": "valid_at",
            "required": false,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "amount": "0",
                      "billing_dimension": "example",
                      "component_key": "example",
                      "component_type": "example",
                      "conditions": [
                        {
                          "type": "context_tokens"
                        }
                      ],
                      "currency": "USD",
                      "is_default_market": false,
                      "market_scope": "mainland_cn",
                      "offering_id": "00000000-0000-7000-8000-000000000001",
                      "price_version_id": "00000000-0000-7000-8000-000000000001",
                      "provenance": {
                        "authority_tier": "official",
                        "freshness": "fresh",
                        "observed_at": "2026-07-30T00:00:00Z",
                        "source_id": "00000000-0000-7000-8000-000000000001",
                        "source_url": "https://api.tokenradar.example/api/v1",
                        "verification_status": "provisional",
                        "verified_at": "2026-07-30T00:00:00Z"
                      },
                      "quantity": 1,
                      "rate_component_id": "00000000-0000-7000-8000-000000000001",
                      "source_region": "example",
                      "unit": "tokens",
                      "usd_standard": {
                        "amount": "0",
                        "conversion_method": "identity",
                        "display_amount": "$0.0000",
                        "observed_at": "2026-07-30T00:00:00Z",
                        "reference_date": "2026-07-30",
                        "source_slug": "example",
                        "source_url": "https://api.tokenradar.example/api/v1",
                        "status": "identity"
                      },
                      "valid_from": "2026-07-30T00:00:00Z",
                      "valid_to": "2026-07-30T00:00:00Z"
                    }
                  ],
                  "meta": {
                    "catalog_epoch": "0",
                    "observed_at": "2026-07-30T00:00:00Z",
                    "snapshot_at": "2026-07-30T00:00:00Z",
                    "verified_at": "2026-07-30T00:00:00Z"
                  },
                  "page": {
                    "limit": 1,
                    "next_cursor": "example"
                  }
                },
                "schema": {
                  "$id": "PriceListResponse",
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "items": {
                        "$ref": "#/components/schemas/PriceReference"
                      },
                      "type": "array"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ResponseMeta"
                    },
                    "page": {
                      "$ref": "#/components/schemas/CursorPage"
                    }
                  },
                  "required": [
                    "data",
                    "page",
                    "meta"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "304": {
            "description": "Not modified"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "example",
                    "message": "example",
                    "request_id": "example"
                  }
                },
                "schema": {
                  "$id": "ApiError",
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "additionalProperties": false,
                      "properties": {
                        "code": {
                          "maxLength": 128,
                          "minLength": 1,
                          "pattern": "^[a-z0-9_]+$",
                          "type": "string"
                        },
                        "fields": {
                          "items": {
                            "$ref": "#/components/schemas/ApiErrorField"
                          },
                          "maxItems": 64,
                          "type": "array"
                        },
                        "message": {
                          "maxLength": 512,
                          "minLength": 1,
                          "type": "string"
                        },
                        "request_id": {
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "request_id"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "List component-level public price versions",
        "tags": [
          "Prices"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "public_etag",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "catalog_read",
        "x-tokenradar-stable-errors": [
          {
            "code": "validation_error",
            "description": "The request does not satisfy the public contract.",
            "status": 400
          },
          {
            "code": "invalid_cursor",
            "description": "The cursor is invalid, expired, or bound to other filters.",
            "status": 400
          },
          {
            "code": "catalog_snapshot_changed",
            "description": "The requested catalog epoch is no longer available.",
            "status": 409
          },
          {
            "code": "rate_limit_exceeded",
            "description": "The anonymous request limit has been reached.",
            "status": 429
          },
          {
            "code": "catalog_unavailable",
            "description": "No safe public catalog snapshot is currently readable.",
            "status": 503
          }
        ]
      }
    },
    "/ready": {
      "get": {
        "description": "Report whether configuration, database schema, and required public read capabilities can serve traffic.",
        "operationId": "getReadiness",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "checks": {
                    "configuration": "ok",
                    "database": "ok",
                    "read_capability": "ok",
                    "schema": "ok"
                  },
                  "status": "ready"
                },
                "schema": {
                  "$id": "ReadyResponse",
                  "additionalProperties": false,
                  "properties": {
                    "checks": {
                      "$ref": "#/components/schemas/ReadinessChecks"
                    },
                    "status": {
                      "const": "ready",
                      "type": "string"
                    }
                  },
                  "required": [
                    "status",
                    "checks"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Successful response"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "checks": {
                    "configuration": "ok",
                    "database": "ok",
                    "read_capability": "ok",
                    "schema": "ok"
                  },
                  "error_code": "DATABASE_UNAVAILABLE",
                  "request_id": "example",
                  "status": "not_ready"
                },
                "schema": {
                  "$id": "NotReadyResponse",
                  "additionalProperties": false,
                  "properties": {
                    "checks": {
                      "$ref": "#/components/schemas/ReadinessChecks"
                    },
                    "error_code": {
                      "anyOf": [
                        {
                          "const": "DATABASE_UNAVAILABLE",
                          "type": "string"
                        },
                        {
                          "const": "SCHEMA_INCOMPATIBLE",
                          "type": "string"
                        },
                        {
                          "const": "READ_CAPABILITY_UNAVAILABLE",
                          "type": "string"
                        }
                      ]
                    },
                    "request_id": {
                      "maxLength": 128,
                      "minLength": 1,
                      "type": "string"
                    },
                    "status": {
                      "const": "not_ready",
                      "type": "string"
                    }
                  },
                  "required": [
                    "status",
                    "checks",
                    "error_code",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Error response"
          }
        },
        "summary": "Return traffic readiness",
        "tags": [
          "Operations"
        ],
        "x-tokenradar-authorization": "anonymous",
        "x-tokenradar-cache-policy": "no_store",
        "x-tokenradar-database-role": "public_reader",
        "x-tokenradar-rate-limit-group": "health",
        "x-tokenradar-stable-errors": [
          {
            "code": "DATABASE_UNAVAILABLE",
            "description": "The database cannot be reached.",
            "status": 503
          },
          {
            "code": "SCHEMA_INCOMPATIBLE",
            "description": "The required migration has not been applied.",
            "status": 503
          },
          {
            "code": "READ_CAPABILITY_UNAVAILABLE",
            "description": "A required public relation or permission is unavailable.",
            "status": 503
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "/api/v1"
    }
  ],
  "tags": [
    {
      "description": "Business categories operations in the TokenRadar public API.",
      "name": "Business categories"
    },
    {
      "description": "Catalog operations in the TokenRadar public API.",
      "name": "Catalog"
    },
    {
      "description": "Channel providers operations in the TokenRadar public API.",
      "name": "Channel providers"
    },
    {
      "description": "Information channels operations in the TokenRadar public API.",
      "name": "Information channels"
    },
    {
      "description": "Model manufacturers operations in the TokenRadar public API.",
      "name": "Model manufacturers"
    },
    {
      "description": "Models operations in the TokenRadar public API.",
      "name": "Models"
    },
    {
      "description": "Offers operations in the TokenRadar public API.",
      "name": "Offers"
    },
    {
      "description": "Operations operations in the TokenRadar public API.",
      "name": "Operations"
    },
    {
      "description": "Prices operations in the TokenRadar public API.",
      "name": "Prices"
    },
    {
      "description": "Reference data operations in the TokenRadar public API.",
      "name": "Reference data"
    }
  ]
}