{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/chnlsync-com/json-schema/chnlsync-com-copper-retirement-response-schema.json",
  "title": "CopperRetirementResponse",
  "description": "Deterministic copper-retirement dataset slice for agent consumers.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/chnlsync-com-copper-retirement-api-openapi.yml#/components/schemas/CopperRetirementResponse",
  "properties": {
    "records": {
      "items": {
        "$ref": "#/$defs/CopperRetirementRecord"
      },
      "type": "array",
      "title": "Records"
    },
    "source": {
      "type": "string",
      "title": "Source"
    },
    "source_url": {
      "type": "string",
      "title": "Source Url"
    },
    "license": {
      "type": "string",
      "title": "License",
      "default": "CC BY 4.0"
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "As Of",
      "description": "As-of date of the static (carrier, state) records; filings carry their own dates."
    },
    "latest_filings": {
      "items": {
        "$ref": "#/$defs/CopperFilingRead"
      },
      "type": "array",
      "title": "Latest Filings",
      "description": "Newest founder-approved filings (most recent 20, narrowed by the same filters)."
    }
  },
  "type": "object",
  "required": [
    "records",
    "source",
    "source_url"
  ],
  "$defs": {
    "CopperFilingRead": {
      "properties": {
        "carrier": {
          "type": "string",
          "title": "Carrier"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "State"
        },
        "kind": {
          "type": "string",
          "title": "Kind"
        },
        "filer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filer"
        },
        "docket": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docket"
        },
        "filed_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filed At"
        },
        "granted_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Granted At"
        },
        "retirement_effective_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Retirement Effective At"
        },
        "geography_detail": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Geography Detail"
        },
        "source_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source Url"
        }
      },
      "type": "object",
      "required": [
        "carrier",
        "state",
        "kind",
        "filer",
        "docket",
        "filed_at",
        "granted_at",
        "retirement_effective_at",
        "geography_detail",
        "source_url"
      ],
      "title": "CopperFilingRead",
      "description": "One founder-approved copper-retirement filing from the copper-watch detector.\n\nPublic-filing facts only (FCC ECFS / carrier disclosure pages) — never\nprospect or buyer data. ``kind`` is the detector's notice type\n(``ecfs_application`` | ``fcc_public_notice`` | ``fcc_grant`` |\n``carrier_website_notice``)."
    },
    "CopperRetirementRecord": {
      "properties": {
        "carrier": {
          "type": "string",
          "title": "Carrier"
        },
        "state": {
          "type": "string",
          "title": "State"
        },
        "retirement_date": {
          "anyOf": [
            {
              "type": "string",
              "format": "date"
            },
            {
              "type": "null"
            }
          ],
          "title": "Retirement Date"
        },
        "status": {
          "type": "string",
          "enum": [
            "date_filed",
            "program_active"
          ],
          "title": "Status"
        },
        "notes": {
          "type": "string",
          "title": "Notes"
        }
      },
      "type": "object",
      "required": [
        "carrier",
        "state",
        "retirement_date",
        "status",
        "notes"
      ],
      "title": "CopperRetirementRecord",
      "description": "One (carrier, state) copper-retirement program entry."
    }
  }
}