sanctions screen changes derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "days": "Look-back window in days; clamped to the log's coverage start (`loggingSince` in the response).",
      "list": "Which OFAC list to report changes from.",
      "program": "Filter every bucket by a single program tag. See /sanctions-screen/programs."
    }
  },
  "output": {
    "type": "object",
    "required": [
      "window",
      "sourcePublishDate",
      "added",
      "removed",
      "modified",
      "counts",
      "disclaimer"
    ],
    "properties": {
      "about": {
        "type": "string",
        "description": "What this response is and where its data comes from, in one sentence."
      },
      "added": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "name",
            "type",
            "programs",
            "list",
            "date"
          ],
          "properties": {
            "id": {
              "type": "integer",
              "description": "OFAC ent_num — use with /sanctions-screen/entity/{id}."
            },
            "date": {
              "type": "string",
              "format": "date",
              "description": "Date WE OBSERVED the change; OFAC's CSV feeds publish no action date."
            },
            "list": {
              "enum": [
                "sdn",
                "cons"
              ],
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "type": {
              "enum": [
                "individual",
                "entity",
                "vessel",
                "aircraft"
              ],
              "type": "string"
            },
            "programs": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Program tags, as filtered by `program`."
            }
          }
        },
        "description": "Newest first."
      },
      "counts": {
        "type": "object",
        "required": [
          "added",
          "removed",
          "modified"
        ],
        "properties": {
          "added": {
            "type": "integer"
          },
          "removed": {
            "type": "integer"
          },
          "modified": {
            "type": "integer"
          }
        }
      },
      "window": {
        "type": "object",
        "required": [
          "from",
          "to",
          "requestedFrom",
          "loggingSince",
          "truncated"
        ],
        "properties": {
          "to": {
            "type": "string",
            "format": "date"
          },
          "from": {
            "type": "string",
            "format": "date",
            "description": "Start actually served — never earlier than loggingSince."
          },
          "truncated": {
            "type": "boolean",
            "description": "True when the requested look-back reached past our coverage."
          },
          "loggingSince": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "First date this log has coverage for. An empty window is only meaningful back to here."
          },
          "requestedFrom": {
            "type": "string",
            "format": "date",
            "description": "to − days, before clamping."
          }
        }
      },
      "related": {
        "type": "object",
        "description": "Next steps as paths on this origin. Each is priced by its own 402 challenge; GET /.well-known/x402 prices the whole origin in one free call.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "removed": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "name",
            "type",
            "programs",
            "list",
            "date"
          ],
          "properties": {
            "id": {
              "type": "integer",
              "description": "OFAC ent_num — use with /sanctions-screen/entity/{id}."
            },
            "date": {
              "type": "string",
              "format": "date",
              "description": "Date WE OBSERVED the change; OFAC's CSV feeds publish no action date."
            },
            "list": {
              "enum": [
                "sdn",
                "cons"
              ],
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "type": {
              "enum": [
                "individual",
                "entity",
                "vessel",
                "aircraft"
              ],
              "type": "string"
            },
            "programs": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Program tags, as filtered by `program`."
            }
          }
        },
        "description": "Newest first."
      },
      "modified": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "name",
            "change",
            "programs",
            "list",
            "date"
          ],
          "properties": {
            "id": {
              "type": "integer"
            },
            "date": {
              "type": "string",
              "format": "date",
              "description": "Date we observed the change."
            },
            "list": {
              "enum": [
                "sdn",
                "cons"
              ],
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "change": {
              "enum": [
                "alias-changed",
                "programs-changed",
                "remarks-changed"
              ],
              "type": "string"
            },
            "programs": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "description": "Newest first."
      },
      "freshness": {
        "type": "object",
        "required": [
          "dataAsOf",
          "ageDays",
          "stalenessThresholdDays",
          "status"
        ],
        "properties": {
          "status": {
            "enum": [
              "complete",
              "stale",
              "error"
            ],
            "type": "string"
          },
          "ageDays": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Whole days from dataAsOf to now."
          },
          "dataAsOf": {
            "type": "string",
            "format": "date",
            "description": "Newest datum: OFAC's publication date."
          },
          "stalenessThresholdDays": {
            "type": "integer"
          }
        },
        "description": "Same shape as the free /coverage teaser, computed when you called."
      },
      "disclaimer": {
        "type": "string"
      },
      "sourcePublishDate": {
        "type": "string",
        "description": "OFAC list publication date backing this answer (audit trail)."
      }
    }
  }
}