{
  "openapi": "3.1.0",
  "info": {
    "title": "Rout Data API",
    "version": "1.0.0-preview",
    "description": "Independent, issuer-sourced card identities, artwork, reviewed reward rules and source verification. Developer preview. No production base URL or uptime SLA has been announced. Published records may be partial. Card artwork and issuer marks remain the property of their owners; source provenance is not a redistribution license.",
    "contact": {
      "name": "Rout",
      "url": "https://www.userout.com"
    }
  },
  "servers": [
    {
      "url": "http://localhost:3001/data/v1",
      "description": "Local development. Replace with your deployed backend URL."
    }
  ],
  "security": [
    {
      "RoutDataKey": []
    }
  ],
  "tags": [
    {
      "name": "Catalog",
      "description": "Read-only card data; never customer banking records."
    }
  ],
  "paths": {
    "/data/artwork/{id}": {
      "servers": [
        {
          "url": "http://localhost:3001",
          "description": "Use the same origin as the data API."
        }
      ],
      "get": {
        "operationId": "getCardArtwork",
        "summary": "Download verified original issuer artwork",
        "tags": [
          "Artwork"
        ],
        "security": [],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Previously received SHA-256 ETag."
          }
        ],
        "responses": {
          "200": {
            "description": "Original issuer image. Preserve its aspect ratio; source provenance does not confer redistribution rights.",
            "headers": {
              "ETag": {
                "schema": {
                  "type": "string"
                },
                "description": "Quoted SHA-256 digest."
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/webp": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/gif": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/svg+xml": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "304": {
            "description": "The supplied ETag matches the current image. No body."
          },
          "404": {
            "description": "No exact artwork is available for this ID."
          },
          "503": {
            "description": "Asset integrity check failed; retry after operator repair."
          }
        }
      }
    },
    "/cards": {
      "get": {
        "operationId": "listCards",
        "summary": "Search card products",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 160
            },
            "description": "Space-separated words; all must match name, issuer or aliases."
          },
          {
            "name": "issuer",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact issuer ID from /issuers."
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[A-Z]{2}$"
            },
            "description": "Verified ISO 3166-1 market code, such as GB, DE, CA or SG. Unspecified legacy markets are excluded."
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[A-Z]{3}$"
            },
            "description": "Exact ISO 4217 card market currency, such as GBP or SGD; no FX conversion."
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact rule category, e.g. dining. Matches published facts, including changed/stale records; inspect verification."
          },
          {
            "name": "benefits",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            },
            "description": "Whether any facts are published; fee-only records also qualify."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 30
            },
            "description": "Page size."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "description": "Next offset from previous page. Cards with assigned artwork sort first, led by curated US popularity, then issuer ID and card ID. Cards without artwork come last, using the same popularity and stable ID order. Review status and published-fact coverage do not affect ordering. Ranking applies before pagination. Popularity is editorial discovery order, not measured market share or a recommendation score. Deduplicate by ID and restart pagination to reconcile live catalog or artwork updates."
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "cards": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CardSummary"
                      }
                    },
                    "total": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "offset": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "nextOffset": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "cards",
                    "total",
                    "offset",
                    "nextOffset"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cards/{id}": {
      "get": {
        "operationId": "getCard",
        "summary": "Get identity, artwork and reviewed facts",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Card"
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cards/{id}/history": {
      "get": {
        "operationId": "getCardHistory",
        "summary": "List published revision metadata",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "versions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "version": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "reviewedAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "publishedAt": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          },
                          "reason": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "version",
                          "reviewedAt",
                          "publishedAt",
                          "reason"
                        ]
                      }
                    }
                  },
                  "required": [
                    "versions"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cards/{id}/verification": {
      "get": {
        "operationId": "getCardVerification",
        "summary": "Inspect daily source verification",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Verification"
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cards/{id}/quality": {
      "get": {
        "operationId": "getCardQuality",
        "summary": "Audit product completeness, exact artwork, source evidence and daily freshness",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Quality"
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cards/{id}/checks": {
      "get": {
        "operationId": "getCardChecks",
        "summary": "Read the source-check audit trail",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable Rout card ID; never a card number or issuer account ID.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]+$"
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0
            },
            "description": "Exclusive check sequence, newest first."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            },
            "description": "Page size."
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checks": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Check"
                      }
                    },
                    "nextBefore": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "checks",
                    "nextBefore"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/changes": {
      "get": {
        "operationId": "getChanges",
        "summary": "Poll published catalog changes",
        "tags": [
          "Catalog"
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Exclusive sequence cursor. Persist nextCursor after processing; repeat until empty. Up to 50 events per response. Source checks use /checks, not this feed."
          }
        ],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "changes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "seq": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "cardId": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string"
                          },
                          "version": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "at": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date-time"
                          }
                        },
                        "required": [
                          "seq",
                          "cardId",
                          "type",
                          "version",
                          "at"
                        ]
                      }
                    },
                    "nextCursor": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  "required": [
                    "changes",
                    "nextCursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/issuers": {
      "get": {
        "operationId": "listIssuers",
        "summary": "List registered source issuers",
        "tags": [
          "Catalog"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "issuers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name"
                        ]
                      }
                    }
                  },
                  "required": [
                    "issuers"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/coverage": {
      "get": {
        "operationId": "getCoverage",
        "summary": "Read measured coverage and completeness",
        "tags": [
          "Catalog"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Coverage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "getVerificationHealth",
        "summary": "Inspect daily collection health",
        "tags": [
          "Catalog"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success. Unknown fields are null or empty arrays; they are not zero-valued benefits.",
            "headers": {
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Health"
                }
              }
            }
          },
          "400": {
            "description": "Invalid path or query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid, expired or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Card or endpoint not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-key limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer",
                  "minimum": 0
                },
                "description": "Seconds to wait."
              },
              "X-Request-Id": {
                "description": "Support correlation ID.",
                "schema": {
                  "type": "string"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Allowed requests per fixed UTC minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in this minute.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "UTC Unix seconds at the next minute boundary.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "500": {
            "description": "Server error. Retry with bounded exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "RoutDataKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "rout_data_<random secret>",
        "description": "Server-side read-only key, provisioned by the operator. Never embed it in a browser or mobile bundle."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "requestId": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "code",
              "message",
              "requestId"
            ]
          }
        },
        "required": [
          "error"
        ]
      },
      "Artwork": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "sourceUrl": {
            "type": "string"
          },
          "sourcePage": {
            "type": "string"
          },
          "sha256": {
            "type": "string"
          },
          "width": {
            "type": "integer",
            "minimum": 0
          },
          "height": {
            "type": "integer",
            "minimum": 0
          },
          "mimeType": {
            "type": "string"
          },
          "reviewedAt": {
            "type": "string"
          },
          "rights": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "sourceUrl",
          "sourcePage",
          "sha256",
          "width",
          "height",
          "mimeType",
          "reviewedAt",
          "rights"
        ]
      },
      "CardSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "issuer": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "issuerId": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "credit",
              "charge",
              "debit"
            ]
          },
          "audience": {
            "type": "string",
            "enum": [
              "personal",
              "business",
              "unknown"
            ]
          },
          "network": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 60
              },
              {
                "type": "null"
              }
            ]
          },
          "active": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "aliases": {
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            }
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 1000,
            "format": "uri"
          },
          "artworkId": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 2,
                "maxLength": 80,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              {
                "type": "null"
              }
            ]
          },
          "market": {
            "type": "object",
            "properties": {
              "countryCode": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "currency": {
                "type": "string",
                "pattern": "^[A-Z]{3}$"
              }
            },
            "required": [
              "countryCode",
              "currency"
            ],
            "additionalProperties": false
          },
          "artwork": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Artwork"
              },
              {
                "type": "null"
              }
            ]
          },
          "hasBenefits": {
            "type": "boolean"
          },
          "version": {
            "type": "integer",
            "minimum": 0
          },
          "verification": {
            "type": "string",
            "enum": [
              "identity-only",
              "reviewed",
              "changed",
              "stale"
            ]
          },
          "quality": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "incomplete"
                ]
              },
              "allChecksPassed": {
                "type": "boolean"
              },
              "passed": {
                "type": "integer",
                "minimum": 0
              },
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "asOf": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              }
            },
            "required": [
              "status",
              "allChecksPassed",
              "passed",
              "total",
              "asOf"
            ],
            "description": "Present on search results. Full review requires every quality check, current evidence and successful checks within 24 hours. The legacy verification field alone does not mean fully reviewed."
          }
        },
        "required": [
          "id",
          "name",
          "issuer",
          "issuerId",
          "kind",
          "audience",
          "network",
          "active",
          "aliases",
          "sourceUrl",
          "artworkId",
          "artwork",
          "hasBenefits",
          "version",
          "verification"
        ]
      },
      "Card": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "issuer": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "issuerId": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "credit",
              "charge",
              "debit"
            ]
          },
          "audience": {
            "type": "string",
            "enum": [
              "personal",
              "business",
              "unknown"
            ]
          },
          "network": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 60
              },
              {
                "type": "null"
              }
            ]
          },
          "active": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "aliases": {
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            }
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 1000,
            "format": "uri"
          },
          "artworkId": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 2,
                "maxLength": 80,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              {
                "type": "null"
              }
            ]
          },
          "market": {
            "type": "object",
            "properties": {
              "countryCode": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "currency": {
                "type": "string",
                "pattern": "^[A-Z]{3}$"
              }
            },
            "required": [
              "countryCode",
              "currency"
            ],
            "additionalProperties": false
          },
          "artwork": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Artwork"
              },
              {
                "type": "null"
              }
            ]
          },
          "hasBenefits": {
            "type": "boolean"
          },
          "version": {
            "type": "integer",
            "minimum": 0
          },
          "verification": {
            "type": "string",
            "enum": [
              "identity-only",
              "reviewed",
              "changed",
              "stale"
            ]
          },
          "quality": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "incomplete"
                ]
              },
              "allChecksPassed": {
                "type": "boolean"
              },
              "passed": {
                "type": "integer",
                "minimum": 0
              },
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "asOf": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              }
            },
            "required": [
              "status",
              "allChecksPassed",
              "passed",
              "total",
              "asOf"
            ],
            "description": "Present on search results. Full review requires every quality check, current evidence and successful checks within 24 hours. The legacy verification field alone does not mean fully reviewed."
          },
          "facts": {
            "$ref": "#/components/schemas/Facts"
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "reviewedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "checkedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "changePending": {
            "type": "boolean"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "checkedAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "state": {
                  "type": "string"
                },
                "hash": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "url",
                "checkedAt",
                "state",
                "hash"
              ]
            }
          }
        },
        "required": [
          "id",
          "name",
          "issuer",
          "issuerId",
          "kind",
          "audience",
          "network",
          "active",
          "aliases",
          "sourceUrl",
          "artworkId",
          "artwork",
          "hasBenefits",
          "version",
          "verification",
          "facts",
          "publishedAt",
          "reviewedAt",
          "checkedAt",
          "changePending",
          "sources"
        ]
      },
      "Facts": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "review": {
            "type": "object",
            "properties": {
              "fees": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "rewards": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "benefits": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "offers": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "transfers": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              },
              "eligibility": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "not-applicable",
                      "none-published"
                    ]
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "evidence": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 12,
                              "maxLength": 600
                            }
                          },
                          "required": [
                            "url",
                            "quote"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "maxLength": 1000,
                              "format": "uri"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "textHash": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "url",
                            "start",
                            "end",
                            "textHash"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "status",
                  "summary",
                  "evidence"
                ],
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "terms": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 80,
                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "interest",
                    "fee",
                    "eligibility",
                    "redemption",
                    "other"
                  ]
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 160
                },
                "description": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000
                },
                "evidence": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "quote": {
                          "type": "string",
                          "minLength": 12,
                          "maxLength": 600
                        }
                      },
                      "required": [
                        "url",
                        "quote"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        "textHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "url",
                        "start",
                        "end",
                        "textHash"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "required": [
                "id",
                "type",
                "title",
                "description",
                "evidence"
              ],
              "additionalProperties": false
            }
          },
          "recurringFee": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 10000000
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$"
                  },
                  "period": {
                    "type": "string",
                    "enum": [
                      "month",
                      "year"
                    ]
                  },
                  "conditions": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "evidence": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 12,
                            "maxLength": 600
                          }
                        },
                        "required": [
                          "url",
                          "quote"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "start": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "textHash": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "required": [
                          "url",
                          "start",
                          "end",
                          "textHash"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "amount",
                  "currency",
                  "period",
                  "conditions",
                  "evidence"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "annualFee": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amountUsd": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 20000
                  },
                  "conditions": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "evidence": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 12,
                            "maxLength": 600
                          }
                        },
                        "required": [
                          "url",
                          "quote"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "start": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "textHash": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "required": [
                          "url",
                          "start",
                          "end",
                          "textHash"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "amountUsd",
                  "conditions",
                  "evidence"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "foreignFee": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "percent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 15
                  },
                  "conditions": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "evidence": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 12,
                            "maxLength": 600
                          }
                        },
                        "required": [
                          "url",
                          "quote"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "start": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "textHash": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "required": [
                          "url",
                          "start",
                          "end",
                          "textHash"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "percent",
                  "conditions",
                  "evidence"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "program": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 150
                  },
                  "evidence": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 12,
                            "maxLength": 600
                          }
                        },
                        "required": [
                          "url",
                          "quote"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "maxLength": 1000,
                            "format": "uri"
                          },
                          "start": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "textHash": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "required": [
                          "url",
                          "start",
                          "end",
                          "textHash"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "name",
                  "evidence"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "rules": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 80,
                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                },
                "category": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "rate": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 100
                },
                "unit": {
                  "type": "string",
                  "enum": [
                    "points",
                    "miles",
                    "percent"
                  ]
                },
                "spendBasis": {
                  "type": "object",
                  "properties": {
                    "amount": {
                      "type": "number",
                      "exclusiveMinimum": 0,
                      "maximum": 1000000
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$"
                    }
                  },
                  "required": [
                    "amount",
                    "currency"
                  ],
                  "additionalProperties": false
                },
                "description": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 3000
                },
                "channel": {
                  "type": "string",
                  "enum": [
                    "any",
                    "direct",
                    "issuer-portal",
                    "unknown"
                  ]
                },
                "enrollment": {
                  "type": "string",
                  "enum": [
                    "required",
                    "not-required",
                    "unknown"
                  ]
                },
                "requiresCategorySelection": {
                  "type": "boolean"
                },
                "cap": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "amountUsd": {
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 10000000
                        },
                        "period": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "group": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 80,
                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                        },
                        "afterRate": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "amountUsd",
                        "period",
                        "group",
                        "afterRate"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "capMoney": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 1000000000
                        },
                        "currency": {
                          "type": "string",
                          "pattern": "^[A-Z]{3}$"
                        },
                        "period": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "group": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 80,
                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                        },
                        "afterRate": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "amount",
                        "currency",
                        "period",
                        "group",
                        "afterRate"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "startsOn": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "endsOn": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "exclusions": {
                  "maxItems": 30,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  }
                },
                "evidence": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "quote": {
                          "type": "string",
                          "minLength": 12,
                          "maxLength": 600
                        }
                      },
                      "required": [
                        "url",
                        "quote"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        "textHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "url",
                        "start",
                        "end",
                        "textHash"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "required": [
                "id",
                "category",
                "rate",
                "unit",
                "description",
                "channel",
                "enrollment",
                "cap",
                "startsOn",
                "endsOn",
                "exclusions",
                "evidence"
              ],
              "additionalProperties": false
            }
          },
          "benefits": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 80,
                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 160
                },
                "description": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000
                },
                "enrollment": {
                  "type": "string",
                  "enum": [
                    "required",
                    "not-required",
                    "unknown"
                  ]
                },
                "applicableNetworks": {
                  "minItems": 1,
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60
                  }
                },
                "evidence": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "quote": {
                          "type": "string",
                          "minLength": 12,
                          "maxLength": 600
                        }
                      },
                      "required": [
                        "url",
                        "quote"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        "textHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "url",
                        "start",
                        "end",
                        "textHash"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "required": [
                "id",
                "title",
                "description",
                "enrollment",
                "evidence"
              ],
              "additionalProperties": false
            }
          },
          "offers": {
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 80,
                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                },
                "description": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 3000
                },
                "expiresOn": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "targeted": {
                  "type": "boolean"
                },
                "evidence": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "quote": {
                          "type": "string",
                          "minLength": 12,
                          "maxLength": 600
                        }
                      },
                      "required": [
                        "url",
                        "quote"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        "textHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "url",
                        "start",
                        "end",
                        "textHash"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "required": [
                "id",
                "description",
                "expiresOn",
                "targeted",
                "evidence"
              ],
              "additionalProperties": false
            }
          },
          "transfers": {
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "program": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150
                },
                "ratio": {
                  "anyOf": [
                    {
                      "type": "number",
                      "exclusiveMinimum": 0,
                      "maximum": 100
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "conditions": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 3000
                },
                "evidence": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "quote": {
                          "type": "string",
                          "minLength": 12,
                          "maxLength": 600
                        }
                      },
                      "required": [
                        "url",
                        "quote"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 1000,
                          "format": "uri"
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        "textHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "url",
                        "start",
                        "end",
                        "textHash"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "required": [
                "program",
                "ratio",
                "conditions",
                "evidence"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "annualFee",
          "foreignFee",
          "program",
          "rules",
          "benefits",
          "offers",
          "transfers"
        ],
        "additionalProperties": false
      },
      "Quality": {
        "type": "object",
        "properties": {
          "cardId": {
            "type": "string"
          },
          "version": {
            "type": "integer",
            "minimum": 0
          },
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "enum": [
              "complete",
              "incomplete"
            ]
          },
          "allChecksPassed": {
            "type": "boolean"
          },
          "passed": {
            "type": "integer",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "minimum": 0
          },
          "scope": {
            "type": "string"
          },
          "checks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "enum": [
                    "identity",
                    "artwork",
                    "fees",
                    "rewards",
                    "benefits",
                    "offers",
                    "transfers",
                    "eligibility",
                    "evidence",
                    "freshness"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "passed",
                    "missing",
                    "partial",
                    "needs-review"
                  ]
                },
                "detail": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "label",
                "status",
                "detail"
              ]
            }
          }
        },
        "required": [
          "cardId",
          "version",
          "asOf",
          "status",
          "allChecksPassed",
          "passed",
          "total",
          "scope",
          "checks"
        ]
      },
      "Check": {
        "type": "object",
        "properties": {
          "seq": {
            "type": "integer",
            "minimum": 0
          },
          "sourceUrl": {
            "type": "string"
          },
          "startedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "finishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "initial",
              "unchanged",
              "changed",
              "unavailable"
            ]
          },
          "httpStatus": {
            "type": [
              "integer",
              "null"
            ]
          },
          "previousHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "hash": {
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "seq",
          "sourceUrl",
          "startedAt",
          "finishedAt",
          "outcome",
          "httpStatus",
          "previousHash",
          "hash",
          "reason"
        ]
      },
      "Verification": {
        "type": "object",
        "properties": {
          "cardId": {
            "type": "string"
          },
          "version": {
            "type": "integer",
            "minimum": 0
          },
          "status": {
            "type": "string",
            "enum": [
              "confirmed",
              "identity-observed",
              "changed",
              "unavailable",
              "overdue"
            ]
          },
          "targetIntervalHours": {
            "const": 24
          },
          "meaning": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "lastSuccessfulCheckAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "dueAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "confirmedWithin24Hours": {
                  "type": "boolean"
                },
                "lastCheck": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "seq": {
                          "type": "integer",
                          "minimum": 0
                        },
                        "finishedAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time"
                        },
                        "outcome": {
                          "type": "string"
                        },
                        "httpStatus": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "hash": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "reason": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "seq",
                        "finishedAt",
                        "outcome",
                        "httpStatus",
                        "hash",
                        "reason"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "url",
                "lastSuccessfulCheckAt",
                "dueAt",
                "confirmedWithin24Hours",
                "lastCheck"
              ]
            }
          }
        },
        "required": [
          "cardId",
          "version",
          "status",
          "targetIntervalHours",
          "meaning",
          "sources"
        ]
      },
      "Coverage": {
        "type": "object",
        "properties": {
          "provider": {
            "const": "rout"
          },
          "cards": {
            "type": "integer",
            "minimum": 0
          },
          "issuers": {
            "type": "integer",
            "minimum": 0
          },
          "withBenefits": {
            "type": "integer",
            "minimum": 0
          },
          "fullyReviewed": {
            "type": "integer",
            "minimum": 0,
            "description": "Cards currently passing every product quality check. withBenefits counts any published facts, including incomplete records."
          },
          "reviewed": {
            "type": "integer",
            "minimum": 0
          },
          "identityOnly": {
            "type": "integer",
            "minimum": 0
          },
          "changed": {
            "type": "integer",
            "minimum": 0
          },
          "stale": {
            "type": "integer",
            "minimum": 0
          },
          "artwork": {
            "type": "integer",
            "minimum": 0
          },
          "discoveryCandidates": {
            "type": "integer",
            "minimum": 0
          },
          "sourceErrors": {
            "type": "integer",
            "minimum": 0
          },
          "target": {
            "type": "integer",
            "minimum": 0
          },
          "targetBasis": {
            "type": "string"
          },
          "parityAchieved": {
            "type": "boolean"
          },
          "remainingIdentities": {
            "type": "integer",
            "minimum": 0
          },
          "registeredIssuers": {
            "type": "integer",
            "minimum": 0
          },
          "note": {
            "type": "string"
          },
          "byIssuer": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "issuerId": {
                  "type": "string"
                },
                "identities": {
                  "type": "integer",
                  "minimum": 0
                },
                "reviewedRecords": {
                  "type": "integer",
                  "minimum": 0
                },
                "withAnnualFee": {
                  "type": "integer",
                  "minimum": 0
                },
                "withRecurringFee": {
                  "type": "integer",
                  "minimum": 0
                },
                "withForeignFee": {
                  "type": "integer",
                  "minimum": 0
                },
                "withRewardRules": {
                  "type": "integer",
                  "minimum": 0
                },
                "withPerks": {
                  "type": "integer",
                  "minimum": 0
                },
                "withOffers": {
                  "type": "integer",
                  "minimum": 0
                },
                "withTransfers": {
                  "type": "integer",
                  "minimum": 0
                },
                "withArtwork": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "required": [
                "issuerId",
                "identities",
                "reviewedRecords",
                "withAnnualFee",
                "withRecurringFee",
                "withForeignFee",
                "withRewardRules",
                "withPerks",
                "withOffers",
                "withTransfers",
                "withArtwork"
              ]
            }
          }
        },
        "required": [
          "provider",
          "cards",
          "issuers",
          "withBenefits",
          "fullyReviewed",
          "reviewed",
          "identityOnly",
          "changed",
          "stale",
          "artwork",
          "discoveryCandidates",
          "sourceErrors",
          "target",
          "targetBasis",
          "parityAchieved",
          "remainingIdentities",
          "registeredIssuers",
          "note",
          "byIssuer"
        ]
      },
      "Health": {
        "type": "object",
        "properties": {
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "targetIntervalHours": {
            "const": 24
          },
          "cards": {
            "type": "object",
            "properties": {
              "confirmed": {
                "type": "integer",
                "minimum": 0
              },
              "identity-observed": {
                "type": "integer",
                "minimum": 0
              },
              "changed": {
                "type": "integer",
                "minimum": 0
              },
              "unavailable": {
                "type": "integer",
                "minimum": 0
              },
              "overdue": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "confirmed",
              "identity-observed",
              "changed",
              "unavailable",
              "overdue"
            ]
          },
          "sources": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "due": {
                "type": "integer",
                "minimum": 0
              },
              "successfulWithin24Hours": {
                "type": "integer",
                "minimum": 0
              },
              "unavailable": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "total",
              "due",
              "successfulWithin24Hours",
              "unavailable"
            ]
          },
          "checksInLast24Hours": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "outcome": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "required": [
                "outcome",
                "count"
              ]
            }
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "asOf",
          "targetIntervalHours",
          "cards",
          "sources",
          "checksInLast24Hours",
          "note"
        ]
      }
    }
  }
}
