ScreenResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/jid-com/json-schema/jid-com-screen-result-schema.json",
  "title": "ScreenResult",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/jid-com-openapi.json#/components/schemas/ScreenResult",
  "type": "object",
  "properties": {
    "engage": {
      "type": "boolean"
    },
    "risk": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "unknown"
      ]
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "subject_type": {
      "type": "string",
      "enum": [
        "business",
        "individual_or_unverified",
        "website"
      ]
    },
    "summary": {
      "type": "string"
    },
    "hard_rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "risk_points": {
      "type": "number"
    },
    "reasons": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "hard",
              "negative",
              "positive",
              "info",
              "skipped"
            ]
          },
          "points": {
            "type": "number"
          },
          "text": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "checked_at": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "mitigations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        }
      }
    },
    "entity": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "match_confidence": {
          "type": "string"
        },
        "relied_on": {
          "type": "boolean"
        }
      }
    },
    "checks": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Check"
      }
    },
    "read": {
      "$ref": "#/$defs/Read"
    },
    "website_declared": {
      "oneOf": [
        {
          "$ref": "#/$defs/WebsiteDeclared"
        },
        {
          "type": "null"
        }
      ]
    },
    "outcome_links": {
      "$ref": "#/$defs/OutcomeLinks"
    },
    "check_runs": {
      "type": "object",
      "description": "Which live lookups ran (this was `checks` before 2026-10-05).",
      "additionalProperties": {
        "type": "string",
        "enum": [
          "done",
          "cached",
          "skipped",
          "not_applicable",
          "failed"
        ]
      }
    },
    "receipt_id": {
      "type": "string"
    },
    "receipt_url": {
      "type": "string"
    },
    "rules_version": {
      "type": "string"
    },
    "latency_ms": {
      "type": "number"
    },
    "checks_used": {
      "type": "number"
    },
    "location": {
      "type": "object",
      "description": "Present when location inputs were given",
      "properties": {
        "consistent": {
          "type": [
            "boolean",
            "string"
          ],
          "description": "true, false or \"unknown\""
        },
        "reference": {
          "type": [
            "object",
            "null"
          ]
        },
        "signals": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "network": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "tor",
                "hosting_or_vpn",
                "other",
                "unknown"
              ]
            },
            "asn": {
              "type": [
                "integer",
                "null"
              ]
            },
            "source": {
              "type": "string"
            }
          }
        },
        "detail": {
          "type": "string"
        }
      }
    }
  },
  "$defs": {
    "Check": {
      "type": "object",
      "description": "One check from the registry. New checks add rows, never fields.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Stable id: registered, sanctions, threat_feeds, email_address, mail_domain, domain_age, website, affiliation, adverse_records, licence, phone, location, enquiry, funding, complaints, lookalike_domain, email_auth, history"
        },
        "label": {
          "type": "string"
        },
        "group": {
          "type": "string",
          "enum": [
            "identity",
            "legitimacy",
            "safety",
            "location",
            "capacity",
            "history"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "pass",
            "fail",
            "unknown",
            "na"
          ]
        },
        "severity": {
          "type": "string",
          "enum": [
            "block",
            "warn",
            "info"
          ],
          "description": "What a fail means: block = do not engage, warn = verify first, info = never changes the recommendation"
        },
        "evidence": {
          "type": "string"
        },
        "lookup": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          }
        },
        "phrase": {
          "type": "string"
        }
      }
    },
    "OutcomeLinks": {
      "type": "object",
      "description": "Keyed calls only: signed one-click URLs that record an outcome (POST /v1/outcomes) without a login.",
      "properties": {
        "legit": {
          "type": "string"
        },
        "sales_pitch": {
          "type": "string"
        },
        "spam": {
          "type": "string"
        },
        "scam": {
          "type": "string"
        },
        "closed": {
          "type": "string"
        },
        "good": {
          "type": "string",
          "description": "2026-10-05 button, still accepted"
        },
        "junk": {
          "type": "string",
          "description": "2026-10-05 button, still accepted"
        }
      }
    },
    "Read": {
      "type": "object",
      "description": "What to show a human: render this and nothing else.",
      "properties": {
        "headline": {
          "type": "string"
        },
        "recommendation": {
          "type": "string",
          "enum": [
            "engage",
            "verify_first",
            "do_not_engage"
          ]
        },
        "passed": {
          "type": "integer"
        },
        "total": {
          "type": "integer",
          "description": "Checks that ran (status pass or fail) and decide (severity block or warn), plus location consistency, which is counted but never decides"
        },
        "reason": {
          "type": "string",
          "description": "Why a read with no registry match is not engage, e.g. \"Not found on the registers Jid checks for Indonesia (LEI records only)\". Also in the headline, followed by \", so: verify first\"."
        },
        "not_checked": {
          "type": "array",
          "maxItems": 4,
          "items": {
            "type": "string"
          },
          "description": "Labels of deciding checks that did not run or did not finish"
        },
        "sender": {
          "type": "string",
          "description": "Qualify only, response only (never stored): the Jid Signals location next to the stated place and the company domain's age"
        },
        "failed": {
          "type": "array",
          "maxItems": 3,
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "evidence": {
                "type": "string"
              },
              "lookup": {
                "type": "object"
              }
            }
          }
        },
        "lookups": {
          "type": "array",
          "maxItems": 4,
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          }
        },
        "file_url": {
          "type": "string"
        },
        "subject": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "WebsiteDeclared": {
      "type": "object",
      "description": "What a company's own website states about itself (provenance tier website_declared): identity context only, never a registry result. Present only when no Jid file holds or is associated with the domain.",
      "properties": {
        "tier": {
          "type": "string",
          "enum": [
            "website_declared"
          ]
        },
        "domain": {
          "type": "string"
        },
        "legal_name": {
          "type": "string",
          "description": "As printed, with its legal form"
        },
        "trade_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "address": {
          "type": [
            "string",
            "null"
          ],
          "description": "As printed; null when the site prints addresses in several states"
        },
        "state": {
          "type": [
            "string",
            "null"
          ]
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_url": {
          "type": "string"
        },
        "read_at": {
          "type": "string",
          "format": "date-time"
        },
        "how": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      }
    }
  }
}