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"
        },
        "domain": {
          "description": "The domain as given (host part).",
          "examples": [
            "github.com"
          ],
          "type": "string"
        },
        "domain_ascii": {
          "description": "ASCII (punycode) form queried.",
          "examples": [
            "github.com"
          ],
          "type": "string"
        },
        "email_security": {
          "description": "Email authentication policy.",
          "properties": {
            "dmarc": {
              "$ref": "#/components/schemas/Dmarc"
            },
            "spf": {
              "$ref": "#/components/schemas/Spf"
            }
          },
          "required": [
            "spf",
            "dmarc"
          ],
          "type": "object"
        },
        "exists": {
          "description": "The domain exists in DNS.",
          "examples": [
            true
          ],
          "type": "boolean"
        },
        "notes": {
          "description": "Findings and caveats.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "No DMARC record."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "records": {
          "description": "Records by type; empty when none.",
          "properties": {
            "a": {
              "description": "A records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A A record.",
                "examples": [
                  "140.82.112.3"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "aaaa": {
              "description": "AAAA records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A AAAA record.",
                "examples": [
                  "2606:50c0:8000::153"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "caa": {
              "description": "CAA records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A CAA record.",
                "examples": [
                  "0 issue \"digicert.com\""
                ],
                "type": "string"
              },
              "type": "array"
            },
            "cname": {
              "description": "CNAME records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A CNAME record.",
                "examples": [
                  "github.github.io"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "mx": {
              "description": "MX records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A MX record.",
                "examples": [
                  "1 aspmx.l.google.com"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "ns": {
              "description": "NS records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A NS record.",
                "examples": [
                  "dns1.p08.nsone.net"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "soa": {
              "description": "SOA records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A SOA record.",
                "examples": [
                  "dns1.p08.nsone.net hostmaster.nsone.net serial=1 refresh=43200 retry=7200 expire=1209600 minimum=3600"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "txt": {
              "description": "TXT records.",
              "examples": [
                []
              ],
              "items": {
                "description": "A TXT record.",
                "examples": [
                  "v=spf1 include:_spf.google.com ~all"
                ],
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "a",
            "aaaa",
            "cname",
            "mx",
            "ns",
            "txt",
            "caa",
            "soa"
          ],
          "type": "object"
        },
        "tls": {
          "description": "HTTPS certificate; null when not checked.",
          "properties": {
            "days_remaining": {
              "description": "Days until expiry.",
              "examples": [
                62
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "error": {
              "description": "Why the check failed.",
              "examples": [
                "certificate has expired"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "ip": {
              "description": "Address connected to.",
              "examples": [
                "140.82.112.3"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "issuer": {
              "description": "Issuing CA.",
              "examples": [
                "Sectigo Limited"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "names": {
              "description": "Subject alternative names.",
              "examples": [
                []
              ],
              "items": {
                "description": "A name the certificate covers.",
                "examples": [
                  "www.github.com"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "not_after": {
              "description": "Valid until.",
              "examples": [
                "2026-11-29T23:59:59Z"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "not_before": {
              "description": "Valid from.",
              "examples": [
                "2026-08-01T00:00:00Z"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "protocol": {
              "description": "TLS version.",
              "examples": [
                "TLSv1.3"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "reachable": {
              "description": "An HTTPS server answered on port 443.",
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "subject": {
              "description": "Certificate common name.",
              "examples": [
                "github.com"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "valid": {
              "description": "The certificate verified for this name.",
              "examples": [
                true
              ],
              "type": "boolean"
            }
          },
          "required": [
            "reachable",
            "valid",
            "error",
            "ip"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "domain",
        "domain_ascii",
        "exists",
        "records",
        "email_security",
        "tls",
        "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": "domain.dns response",
  "type": "object"
}