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": {
        "attribution": {
          "description": "Data credit.",
          "properties": {
            "license": {
              "description": "Data licence.",
              "examples": [
                "Creative Commons Attribution 4.0 International"
              ],
              "type": "string"
            },
            "text": {
              "description": "Credit required by the licence.",
              "examples": [
                "IP Geolocation by DB-IP"
              ],
              "type": "string"
            },
            "url": {
              "description": "Credit link.",
              "examples": [
                "https://db-ip.com"
              ],
              "type": "string"
            }
          },
          "required": [
            "text",
            "url",
            "license"
          ],
          "type": "object"
        },
        "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"
        },
        "database_month": {
          "description": "DB-IP Lite edition used (YYYY-MM).",
          "examples": [
            "2026-09"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "ip": {
          "description": "The address, normalised.",
          "examples": [
            "8.8.8.8"
          ],
          "type": "string"
        },
        "location": {
          "description": "Registered location; null for a non-public or unknown address.",
          "properties": {
            "city": {
              "description": "City.",
              "examples": [
                "Mountain View"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "continent": {
              "description": "Continent.",
              "examples": [
                "North America"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "country": {
              "description": "Country.",
              "examples": [
                "United States"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "country_code": {
              "description": "ISO code.",
              "examples": [
                "US"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "latitude": {
              "description": "Latitude.",
              "examples": [
                37.422
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "longitude": {
              "description": "Longitude.",
              "examples": [
                -122.085
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "region": {
              "description": "Region or state.",
              "examples": [
                "California"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "city",
            "region",
            "country",
            "country_code",
            "continent",
            "latitude",
            "longitude"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "network": {
          "description": "Who runs the network; null when unknown.",
          "properties": {
            "asn": {
              "description": "Autonomous system number.",
              "examples": [
                15169
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "organization": {
              "description": "Network operator.",
              "examples": [
                "Google LLC"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "asn",
            "organization"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "notes": {
          "description": "Caveats.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "IP location is approximate."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "reverse_dns": {
          "description": "Reverse DNS names.",
          "examples": [
            [
              "dns.google"
            ]
          ],
          "items": {
            "description": "A PTR name.",
            "examples": [
              "dns.google"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "scope": {
          "description": "public addresses are looked up; others are described from the address alone.",
          "enum": [
            "public",
            "private",
            "loopback",
            "link_local",
            "multicast",
            "shared",
            "reserved"
          ],
          "examples": [
            "public"
          ],
          "type": "string"
        },
        "version": {
          "description": "4 or 6.",
          "examples": [
            4
          ],
          "type": "integer"
        }
      },
      "required": [
        "ip",
        "version",
        "scope",
        "reverse_dns",
        "location",
        "network",
        "database_month",
        "attribution",
        "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": "ip.lookup response",
  "type": "object"
}