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": {
        "availability": {
          "description": "Availability of the option asked for (or of the product when no variant was named).",
          "enum": [
            "in_stock",
            "out_of_stock",
            "preorder",
            "backorder",
            "limited",
            "discontinued",
            "unknown"
          ],
          "examples": [
            "in_stock"
          ],
          "type": "string"
        },
        "available": {
          "description": "Purchasable or bookable right now under the conditions asked; null when the page does not say.",
          "examples": [
            true
          ],
          "type": [
            "boolean",
            "null"
          ]
        },
        "checked_at": {
          "description": "When the page was read (UTC). The answer was true at this moment; nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "confidence": {
          "description": "high: exact structured data for the option asked; medium: page-level tags only; low: model reading or nothing found.",
          "enum": [
            "high",
            "medium",
            "low"
          ],
          "examples": [
            "high"
          ],
          "type": "string"
        },
        "currency": {
          "description": "ISO 4217 currency of `price`; null when not stated.",
          "examples": [
            "USD"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "eligibility_notes": {
          "description": "Restrictions and caveats, in words.",
          "examples": [
            []
          ],
          "items": {
            "description": "A restriction or caveat the page states, or why a condition could not be checked.",
            "examples": [
              "Ships to US, CA and GB only."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "evidence": {
          "description": "The evidence behind the answer, best first.",
          "items": {
            "description": "What the answer rests on: a structured-data field or an exact quote from the page.",
            "examples": [
              "JSON-LD Offer availability https://schema.org/InStock price 110 USD"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "final_url": {
          "description": "The URL after redirects.",
          "examples": [
            "https://example.com/products/wool-runner"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "http_status": {
          "description": "HTTP status of the page fetch.",
          "examples": [
            200
          ],
          "type": [
            "integer",
            "null"
          ]
        },
        "javascript_rendered": {
          "description": "Whether a real browser had to render the page to answer.",
          "examples": [
            false
          ],
          "type": "boolean"
        },
        "language": {
          "description": "BCP-47 tag the prose fields were written in; null for the page's own language.",
          "examples": [
            "en"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "matched_option": {
          "description": "The option matching `variant`; null when no variant was asked or none matched.",
          "properties": {
            "availability": {
              "description": "Availability of this option.",
              "enum": [
                "in_stock",
                "out_of_stock",
                "preorder",
                "backorder",
                "limited",
                "discontinued",
                "unknown"
              ],
              "examples": [
                "in_stock"
              ],
              "type": "string"
            },
            "available": {
              "description": "Purchasable now; null when the page does not say.",
              "examples": [
                true
              ],
              "type": [
                "boolean",
                "null"
              ]
            },
            "currency": {
              "description": "ISO 4217 code; null when not stated.",
              "examples": [
                "USD"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "The option as the page names it.",
              "examples": [
                "Natural Black / 10"
              ],
              "type": "string"
            },
            "price": {
              "description": "Price of this option; null when not stated.",
              "examples": [
                110
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "sku": {
              "description": "SKU when the page states one.",
              "examples": [
                "WR3MNCW100"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "url": {
              "description": "Option-specific URL when the page gives one.",
              "examples": [
                "https://example.com/products/wool-runner?variant=10"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "name",
            "available",
            "availability",
            "price",
            "currency"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "model": {
          "description": "The model used, only when the model layer ran.",
          "examples": [
            "gemini-2.5-flash"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "options": {
          "description": "Every purchasable variation the page lists (sizes, colours, dates, rooms, fares).",
          "items": {
            "description": "One purchasable variation.",
            "properties": {
              "availability": {
                "description": "Availability of this option.",
                "enum": [
                  "in_stock",
                  "out_of_stock",
                  "preorder",
                  "backorder",
                  "limited",
                  "discontinued",
                  "unknown"
                ],
                "examples": [
                  "in_stock"
                ],
                "type": "string"
              },
              "available": {
                "description": "Purchasable now; null when the page does not say.",
                "examples": [
                  true
                ],
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "currency": {
                "description": "ISO 4217 code; null when not stated.",
                "examples": [
                  "USD"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "description": "The option as the page names it.",
                "examples": [
                  "Natural Black / 10"
                ],
                "type": "string"
              },
              "price": {
                "description": "Price of this option; null when not stated.",
                "examples": [
                  110
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "sku": {
                "description": "SKU when the page states one.",
                "examples": [
                  "WR3MNCW100"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "description": "Option-specific URL when the page gives one.",
                "examples": [
                  "https://example.com/products/wool-runner?variant=10"
                ],
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "available",
              "availability",
              "price",
              "currency"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "options_count": {
          "description": "How many options the page lists.",
          "examples": [
            7
          ],
          "type": "integer"
        },
        "price": {
          "description": "Price of the matched option, else the product's; null when not stated.",
          "examples": [
            110
          ],
          "type": [
            "number",
            "null"
          ]
        },
        "quantity": {
          "description": "The quantity asked for.",
          "examples": [
            2
          ],
          "type": [
            "integer",
            "null"
          ]
        },
        "quantity_ok": {
          "description": "Whether that quantity can be ordered; null when the page does not say.",
          "examples": [
            true
          ],
          "type": [
            "boolean",
            "null"
          ]
        },
        "ship_to": {
          "description": "The country asked for.",
          "examples": [
            "US"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "ship_to_ok": {
          "description": "Whether the page says it delivers there; null when it does not say.",
          "examples": [
            true
          ],
          "type": [
            "boolean",
            "null"
          ]
        },
        "shipping": {
          "description": "What the page states about shipping or delivery; null unless stated.",
          "examples": [
            "Free shipping on orders over $75"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "description": "Which layer answered: the page's JSON-LD, the Shopify product JSON, Open Graph tags, the model over the rendered page, or nothing usable.",
          "enum": [
            "jsonld",
            "shopify",
            "opengraph",
            "llm",
            "none"
          ],
          "examples": [
            "jsonld"
          ],
          "type": "string"
        },
        "title": {
          "description": "Product or listing name from the page.",
          "examples": [
            "Wool Runner"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "description": "The page checked.",
          "examples": [
            "https://example.com/products/wool-runner"
          ],
          "type": "string"
        },
        "variant": {
          "description": "The variant asked for, as given.",
          "examples": [
            "size 10"
          ],
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "url",
        "available",
        "availability",
        "price",
        "currency",
        "options",
        "options_count",
        "matched_option",
        "quantity_ok",
        "ship_to_ok",
        "eligibility_notes",
        "evidence",
        "source",
        "javascript_rendered",
        "confidence",
        "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": "commerce.availability response",
  "type": "object"
}