hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "checks": {
          "description": "Each check's result; null when not asked for or failed.",
          "properties": {
            "email": {
              "description": "email.verify result (verdict, reason, disposable, role_account, free_provider, did_you_mean...), or null.",
              "properties": {
                "reason": {
                  "description": "Why.",
                  "examples": [
                    "mailbox_exists"
                  ],
                  "type": "string"
                },
                "verdict": {
                  "description": "email.verify verdict.",
                  "examples": [
                    "deliverable"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "verdict",
                "reason"
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "ip": {
              "description": "ip.lookup result (scope, location, network, reverse_dns, attribution), or null.",
              "properties": {
                "scope": {
                  "description": "public, private, reserved...",
                  "examples": [
                    "public"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "scope"
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "phone": {
              "description": "phone.parse result (valid, e164, country, region, carrier, line_type), or null.",
              "properties": {
                "line_type": {
                  "description": "Line type.",
                  "examples": [
                    "fixed_line"
                  ],
                  "type": "string"
                },
                "valid": {
                  "description": "Valid number.",
                  "examples": [
                    true
                  ],
                  "type": "boolean"
                }
              },
              "required": [
                "valid",
                "line_type"
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "sanctions": {
              "description": "sanctions.screen result (verdict, match_count, matches[], lists[]), or null.",
              "properties": {
                "match_count": {
                  "description": "Matches.",
                  "examples": [
                    0
                  ],
                  "type": "integer"
                },
                "verdict": {
                  "description": "Screen verdict.",
                  "enum": [
                    "potential_match",
                    "no_match",
                    "incomplete"
                  ],
                  "examples": [
                    "no_match"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "verdict",
                "match_count"
              ],
              "type": [
                "object",
                "null"
              ]
            }
          },
          "required": [
            "sanctions",
            "email",
            "phone",
            "ip"
          ],
          "type": "object"
        },
        "checks_failed": {
          "description": "Checks that failed; the rest still ship.",
          "examples": [
            []
          ],
          "items": {
            "description": "A check that did not complete.",
            "examples": [
              "email"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "checks_run": {
          "description": "Checks that completed.",
          "examples": [
            [
              "sanctions",
              "email"
            ]
          ],
          "items": {
            "description": "A check that completed.",
            "examples": [
              "sanctions"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "flags": {
          "description": "Everything worth a look, most severe first.",
          "examples": [
            []
          ],
          "items": {
            "properties": {
              "code": {
                "description": "Flag code.",
                "examples": [
                  "country_mismatch_ip"
                ],
                "type": "string"
              },
              "detail": {
                "description": "What was found.",
                "examples": [
                  "Stated country GB but the ip is in United States."
                ],
                "type": "string"
              },
              "severity": {
                "description": "How much it matters.",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ],
                "examples": [
                  "low"
                ],
                "type": "string"
              }
            },
            "required": [
              "code",
              "severity",
              "detail"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "input": {
          "description": "What was checked.",
          "properties": {
            "birth_year": {
              "description": "Birth year given.",
              "examples": [
                1980
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "country": {
              "description": "Stated country.",
              "examples": [
                "GB"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "email": {
              "description": "Email checked.",
              "examples": [
                "jane@stripe.com"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "ip": {
              "description": "IP checked.",
              "examples": [
                "8.8.8.8"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Name screened.",
              "examples": [
                "Jane Smith"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "phone": {
              "description": "Phone checked.",
              "examples": [
                "+44 20 7031 3000"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "name",
            "email",
            "phone",
            "ip",
            "country",
            "birth_year"
          ],
          "type": "object"
        },
        "notes": {
          "description": "Notes.",
          "examples": [
            []
          ],
          "items": {
            "description": "A note.",
            "examples": [
              "Flags are leads to review, not a determination."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "risk": {
          "description": "high: a high-severity flag (sanctions match). review: a medium flag. low: none or only low flags.",
          "enum": [
            "low",
            "review",
            "high"
          ],
          "examples": [
            "review"
          ],
          "type": "string"
        }
      },
      "required": [
        "input",
        "risk",
        "flags",
        "checks",
        "checks_run",
        "checks_failed",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "identity.check response",
  "type": "object"
}