ObligationsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentcreditdata-com/json-schema/agentcreditdata-com-obligations-response-schema.json",
  "title": "ObligationsResponse",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentcreditdata-com-openapi.json#/components/schemas/ObligationsResponse",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "subject_id",
    "snapshot_id",
    "as_of",
    "coverage",
    "obligations",
    "events"
  ],
  "properties": {
    "subject_id": {
      "type": "string",
      "minLength": 1
    },
    "snapshot_id": {
      "type": "string",
      "minLength": 1
    },
    "as_of": {
      "type": "string",
      "format": "date-time"
    },
    "coverage": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Coverage"
      }
    },
    "obligations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Obligation"
      }
    },
    "events": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/EconomicEvent"
      }
    }
  },
  "$defs": {
    "Asset": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "symbol",
        "decimals"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1
        },
        "symbol": {
          "type": "string",
          "minLength": 1
        },
        "decimals": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "Coverage": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "source",
        "scope",
        "status",
        "retrieved_at",
        "event_start",
        "event_end",
        "observed_records",
        "reported_total_records",
        "lifecycle_measurable",
        "limitations",
        "evidence_refs"
      ],
      "properties": {
        "source": {
          "type": "string",
          "minLength": 1
        },
        "scope": {
          "type": "string",
          "minLength": 1
        },
        "status": {
          "enum": [
            "COMPLETE_FOR_SCOPE",
            "PARTIAL",
            "ERROR"
          ]
        },
        "retrieved_at": {
          "type": "string",
          "format": "date-time"
        },
        "event_start": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "event_end": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "observed_records": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "reported_total_records": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "lifecycle_measurable": {
          "type": "boolean"
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "EconomicEvent": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "obligation_id",
        "kind",
        "timestamp",
        "asset",
        "amount",
        "principal_applied",
        "actor",
        "counterparty",
        "transaction_hash",
        "log_index",
        "block_hash",
        "basis",
        "evidence_refs"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1
        },
        "obligation_id": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "kind": {
          "enum": [
            "TRANSFER_OBSERVED",
            "BORROW",
            "REPAY",
            "SUPPLY_COLLATERAL",
            "LIQUIDATION",
            "PRINCIPAL_REPAYMENT_APPLIED",
            "REFINANCE",
            "DEFAULT_DECLARED"
          ]
        },
        "timestamp": {
          "type": "integer",
          "minimum": 0
        },
        "asset": {
          "anyOf": [
            {
              "$ref": "#/$defs/Asset"
            },
            {
              "type": "null"
            }
          ]
        },
        "amount": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
              "maxLength": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "principal_applied": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
              "maxLength": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "actor": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "counterparty": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "transaction_hash": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "log_index": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "block_hash": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "basis": {
          "type": "string",
          "minLength": 1
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "Obligation": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "economic_exposure_id",
        "grouping_basis",
        "subject_id",
        "asset",
        "obligation_type",
        "status",
        "original_principal",
        "outstanding_principal",
        "started_at",
        "ended_at",
        "due_at",
        "due_semantics",
        "late",
        "secured",
        "guarantee",
        "repayment_actor",
        "closure_funding",
        "terms_basis",
        "exposure_basis",
        "intervals",
        "relationship",
        "control_epoch_id",
        "evidence_refs",
        "unknowns"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1
        },
        "economic_exposure_id": {
          "type": "string",
          "minLength": 1
        },
        "grouping_basis": {
          "type": "string",
          "minLength": 1
        },
        "subject_id": {
          "type": "string",
          "minLength": 1
        },
        "asset": {
          "$ref": "#/$defs/Asset"
        },
        "obligation_type": {
          "enum": [
            "loan",
            "trade_credit",
            "protocol_position"
          ]
        },
        "status": {
          "enum": [
            "OPEN",
            "SATISFIED",
            "ISSUER_REPORTED_SATISFIED",
            "LIQUIDATED",
            "REFINANCED",
            "DEFAULTED",
            "UNKNOWN"
          ]
        },
        "original_principal": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
              "maxLength": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "outstanding_principal": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
              "maxLength": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "started_at": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "ended_at": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "due_at": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "due_semantics": {
          "enum": [
            "KNOWN",
            "UNKNOWN",
            "NOT_APPLICABLE"
          ]
        },
        "late": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "secured": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "guarantee": {
          "enum": [
            "PRESENT",
            "ABSENT",
            "UNKNOWN"
          ]
        },
        "repayment_actor": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "closure_funding": {
          "enum": [
            "BORROWER_FUNDS",
            "BORROWER_WALLET_SOURCE_UNKNOWN",
            "GUARANTOR",
            "LIQUIDATION",
            "REFINANCING",
            "UNKNOWN"
          ]
        },
        "terms_basis": {
          "enum": [
            "AUTHENTICATED_TERMS",
            "ISSUER_ASSERTION",
            "PROTOCOL_RULES",
            "UNKNOWN"
          ]
        },
        "exposure_basis": {
          "enum": [
            "PRINCIPAL_LEDGER",
            "ISSUER_LIFECYCLE_TRANSFER_CORROBORATED",
            "UNKNOWN"
          ]
        },
        "intervals": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/PrincipalInterval"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "relationship": {
          "$ref": "#/$defs/RelationshipAssertion"
        },
        "control_epoch_id": {
          "type": "string",
          "minLength": 1
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "unknowns": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "PrincipalInterval": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "start",
        "end",
        "outstanding"
      ],
      "properties": {
        "start": {
          "type": "integer",
          "minimum": 0
        },
        "end": {
          "type": "integer",
          "minimum": 0
        },
        "outstanding": {
          "type": "string",
          "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
          "maxLength": 100
        }
      }
    },
    "RelationshipAssertion": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "classification",
        "counterparty",
        "controller_id",
        "basis",
        "evidence_refs"
      ],
      "properties": {
        "classification": {
          "enum": [
            "INDEPENDENT",
            "RELATED",
            "TEST",
            "UNKNOWN"
          ]
        },
        "counterparty": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "controller_id": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "basis": {
          "type": "string",
          "minLength": 1
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    }
  }
}