← All operations
POST/api/v1/wallets/reputation/check

Trust_CheckWalletReputation

Authentication
public
Cache policy
none
Success and errors
200, 400, 401, 403, 404, 409, 410, 422, 500, 503
Stability
v1 stable contract

OpenAPI operation

{
  "operationId": "Trust_CheckWalletReputation",
  "summary": "Evaluate a bounded wallet batch against optional product policy",
  "tags": [
    "Trust"
  ],
  "parameters": [
    {
      "name": "Idempotency-Key",
      "in": "header",
      "required": true,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "wallets": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "networkId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  },
                  "address": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 256
                  }
                },
                "required": [
                  "networkId",
                  "address"
                ],
                "additionalProperties": false
              }
            },
            "policy": {
              "type": "object",
              "properties": {
                "minimumTier": {
                  "type": "string",
                  "enum": [
                    "TRUSTED",
                    "ESTABLISHED",
                    "EMERGING"
                  ]
                },
                "minimumScorePpm": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1000000
                },
                "requireVerifiedAgent": {
                  "default": false,
                  "type": "boolean"
                },
                "maximumAgeSeconds": {
                  "default": 3600,
                  "type": "integer",
                  "minimum": 30,
                  "maximum": 604800
                },
                "failOnUnknown": {
                  "default": true,
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          },
          "required": [
            "wallets"
          ],
          "additionalProperties": false
        }
      }
    }
  },
  "security": [
    {},
    {
      "apiKeyAuth": []
    }
  ],
  "responses": {
    "200": {
      "description": "Success",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "data",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "policy": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "minimumTier": {
                            "type": "string",
                            "enum": [
                              "TRUSTED",
                              "ESTABLISHED",
                              "EMERGING"
                            ]
                          },
                          "minimumScorePpm": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000
                          },
                          "requireVerifiedAgent": {
                            "default": false,
                            "type": "boolean"
                          },
                          "maximumAgeSeconds": {
                            "default": 3600,
                            "type": "integer",
                            "minimum": 30,
                            "maximum": 604800
                          },
                          "failOnUnknown": {
                            "default": true,
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "requireVerifiedAgent",
                          "maximumAgeSeconds",
                          "failOnUnknown"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "results": {
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inputIndex": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "wallet": {
                          "type": "object",
                          "properties": {
                            "locator": {
                              "type": "object",
                              "properties": {
                                "walletLocatorId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "networkId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                },
                                "networkKey": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "networkFamily": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "scheme": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "canonicalAddress": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "resolution": {
                                  "type": "string",
                                  "enum": [
                                    "EXISTING",
                                    "UNKNOWN"
                                  ]
                                }
                              },
                              "required": [
                                "walletLocatorId",
                                "networkId",
                                "networkKey",
                                "networkFamily",
                                "scheme",
                                "canonicalAddress",
                                "resolution"
                              ],
                              "additionalProperties": false
                            },
                            "ambiguous": {
                              "type": "boolean"
                            },
                            "semanticState": {
                              "type": "string",
                              "enum": [
                                "KNOWN",
                                "LIMITED_EVIDENCE",
                                "UNKNOWN",
                                "RISK_SIGNAL_PRESENT"
                              ]
                            },
                            "activitySummary": {
                              "type": "object",
                              "properties": {
                                "availability": {
                                  "type": "string",
                                  "enum": [
                                    "PUBLIC",
                                    "NO_PUBLIC_ACTIVITY",
                                    "UNAVAILABLE"
                                  ]
                                },
                                "observedActivityCount": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "activityKinds": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "latestOccurredAt": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "format": "date-time",
                                      "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "latestObservedAt": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "format": "date-time",
                                      "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "freshness": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "observedAt": {
                                          "type": "string",
                                          "format": "date-time",
                                          "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                        },
                                        "ageSeconds": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "status": {
                                          "type": "string",
                                          "enum": [
                                            "CURRENT",
                                            "STALE"
                                          ]
                                        },
                                        "expiresAt": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "required": [
                                        "observedAt",
                                        "ageSeconds",
                                        "status",
                                        "expiresAt"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "availability",
                                "observedActivityCount",
                                "activityKinds",
                                "latestOccurredAt",
                                "latestObservedAt",
                                "freshness"
                              ],
                              "additionalProperties": false
                            },
                            "assessment": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "publicId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                    },
                                    "walletLocatorId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                    },
                                    "policyVersion": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "tier": {
                                      "type": "string",
                                      "enum": [
                                        "TRUSTED",
                                        "ESTABLISHED",
                                        "EMERGING",
                                        "UNRATED",
                                        "CAUTION",
                                        "BLOCKED"
                                      ]
                                    },
                                    "scorePpm": {
                                      "anyOf": [
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 1000000
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "confidencePpm": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000
                                    },
                                    "assessedAt": {
                                      "type": "string",
                                      "format": "date-time",
                                      "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                    },
                                    "expiresAt": {
                                      "type": "string",
                                      "format": "date-time",
                                      "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                    },
                                    "watermark": {
                                      "type": "string",
                                      "pattern": "^[a-f0-9]{64}$"
                                    },
                                    "factors": {
                                      "maxItems": 250,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "enum": [
                                              "RELATIONSHIP",
                                              "AGENT_TRUST",
                                              "SOURCE_STALENESS",
                                              "MODERATION"
                                            ]
                                          },
                                          "direction": {
                                            "type": "string",
                                            "enum": [
                                              "POSITIVE",
                                              "NEGATIVE",
                                              "NEUTRAL"
                                            ]
                                          },
                                          "weightPpm": {
                                            "type": "integer",
                                            "minimum": -1000000,
                                            "maximum": 1000000
                                          },
                                          "confidencePpm": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000
                                          },
                                          "summary": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 500
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "OWNERSHIP_PROOF",
                                                  "EXECUTION_BINDING",
                                                  "PROTOCOL_OBSERVATION",
                                                  "PRODUCT_EVIDENCE",
                                                  "TRUST_PROJECTION",
                                                  "MODERATION_ACTION"
                                                ]
                                              },
                                              "reference": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 200
                                              },
                                              "evidencePublicId": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "reference",
                                              "evidencePublicId"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "freshness": {
                                            "type": "object",
                                            "properties": {
                                              "observedAt": {
                                                "type": "string",
                                                "format": "date-time",
                                                "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                              },
                                              "ageSeconds": {
                                                "type": "integer",
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "status": {
                                                "type": "string",
                                                "enum": [
                                                  "CURRENT",
                                                  "STALE"
                                                ]
                                              },
                                              "expiresAt": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "format": "date-time",
                                                    "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "observedAt",
                                              "ageSeconds",
                                              "status",
                                              "expiresAt"
                                            ],
                                            "additionalProperties": false
                                          }
                                        },
                                        "required": [
                                          "type",
                                          "direction",
                                          "weightPpm",
                                          "confidencePpm",
                                          "summary",
                                          "source",
                                          "freshness"
                                        ],
                                        "additionalProperties": false
                                      }
                                    },
                                    "associatedAgents": {
                                      "maxItems": 250,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "entityPublicId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                          },
                                          "agent": {
                                            "type": "object",
                                            "properties": {
                                              "canonicalSlug": {
                                                "type": "string"
                                              },
                                              "name": {
                                                "type": "string"
                                              },
                                              "imageUri": {
                                                "anyOf": [
                                                  {
                                                    "type": "string"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "canonicalSlug",
                                              "name",
                                              "imageUri"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "relation": {
                                            "type": "string",
                                            "enum": [
                                              "VERIFIED_OWNER",
                                              "VERIFIED_MANAGER",
                                              "EXECUTION_WALLET",
                                              "REVENUE_WALLET",
                                              "PROTOCOL_DECLARED",
                                              "OBSERVED_ONLY"
                                            ]
                                          },
                                          "verificationState": {
                                            "type": "string",
                                            "enum": [
                                              "UNVERIFIED",
                                              "PARTIAL",
                                              "VERIFIED",
                                              "EXPIRED",
                                              "REVOKED",
                                              "CONFLICTED"
                                            ]
                                          },
                                          "purpose": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 100
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          },
                                          "confidencePpm": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 1000000
                                          },
                                          "validFrom": {
                                            "type": "string",
                                            "format": "date-time",
                                            "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                          },
                                          "validTo": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "format": "date-time",
                                                "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          },
                                          "proofType": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 100
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "OWNERSHIP_PROOF",
                                                  "EXECUTION_BINDING",
                                                  "PROTOCOL_OBSERVATION",
                                                  "PRODUCT_EVIDENCE",
                                                  "TRUST_PROJECTION",
                                                  "MODERATION_ACTION"
                                                ]
                                              },
                                              "reference": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 200
                                              },
                                              "evidencePublicId": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "reference",
                                              "evidencePublicId"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "freshness": {
                                            "type": "object",
                                            "properties": {
                                              "observedAt": {
                                                "type": "string",
                                                "format": "date-time",
                                                "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                              },
                                              "ageSeconds": {
                                                "type": "integer",
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "status": {
                                                "type": "string",
                                                "enum": [
                                                  "CURRENT",
                                                  "STALE"
                                                ]
                                              },
                                              "expiresAt": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "format": "date-time",
                                                    "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "observedAt",
                                              "ageSeconds",
                                              "status",
                                              "expiresAt"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "historical": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "entityPublicId",
                                          "agent",
                                          "relation",
                                          "verificationState",
                                          "purpose",
                                          "confidencePpm",
                                          "validFrom",
                                          "validTo",
                                          "proofType",
                                          "source",
                                          "freshness",
                                          "historical"
                                        ],
                                        "additionalProperties": false
                                      }
                                    }
                                  },
                                  "required": [
                                    "publicId",
                                    "walletLocatorId",
                                    "policyVersion",
                                    "tier",
                                    "scorePpm",
                                    "confidencePpm",
                                    "assessedAt",
                                    "expiresAt",
                                    "watermark",
                                    "factors",
                                    "associatedAgents"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "methodology": {
                              "type": "object",
                              "properties": {
                                "policyVersion": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "disclosure": {
                                  "type": "string",
                                  "const": "AgentRanking wallet reputation is a scoped product assessment, not a universal reputation or sanctions determination."
                                }
                              },
                              "required": [
                                "policyVersion",
                                "url",
                                "disclosure"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "locator",
                            "ambiguous",
                            "semanticState",
                            "activitySummary",
                            "assessment",
                            "methodology"
                          ],
                          "additionalProperties": false
                        },
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "PASS",
                            "FAIL",
                            "UNKNOWN"
                          ]
                        },
                        "reasons": {
                          "minItems": 1,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string",
                                "enum": [
                                  "UNKNOWN_WALLET",
                                  "ASSESSMENT_TOO_OLD",
                                  "TIER_TOO_LOW",
                                  "SCORE_UNAVAILABLE",
                                  "SCORE_TOO_LOW",
                                  "VERIFIED_AGENT_REQUIRED",
                                  "POLICY_SATISFIED"
                                ]
                              },
                              "message": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 500
                              }
                            },
                            "required": [
                              "code",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "inputIndex",
                        "wallet",
                        "outcome",
                        "reasons"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "policy",
                  "results"
                ],
                "additionalProperties": false
              },
              "meta": {
                "type": "object",
                "additionalProperties": true,
                "required": [
                  "requestId",
                  "schemaVersion",
                  "buildVersion",
                  "generatedAt",
                  "freshness"
                ],
                "properties": {
                  "requestId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "schemaVersion": {
                    "type": "string"
                  },
                  "buildVersion": {
                    "type": "string"
                  },
                  "generatedAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "freshness": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "projectedAt",
                      "sourceWatermark"
                    ],
                    "properties": {
                      "projectedAt": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date-time"
                      },
                      "sourceWatermark": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "400": {
      "description": "invalid request",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "401": {
      "description": "unauthenticated",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "403": {
      "description": "forbidden",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "404": {
      "description": "not found",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "409": {
      "description": "conflict",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "410": {
      "description": "challenge expired",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "422": {
      "description": "proof invalid",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "500": {
      "description": "internal error",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    },
    "503": {
      "description": "dependency unavailable",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/ApiError"
          }
        }
      }
    }
  },
  "x-auth-mode": "public",
  "x-cache-policy": "none",
  "x-required-scopes": [
    "wallets:read"
  ],
  "x-rate-cost": 20,
  "x-stability": "STABLE"
}