{"openapi":"3.1.0","info":{"title":"Unfret API","description":"Scam, dropshipping and dark-pattern signals for a web shop, a marketplace listing, a second-hand ad or a service provider's site. Start with the [developer guide](/developers): the MCP server, pay-per-check over x402 on `POST /v1/check` (no account; `/llms.txt`, `/.well-known/x402`), or a prepaid pass, sent as `Authorization: Bearer ufk_…`, on `POST /v1/analyze`.","contact":{"email":"hello@unfret.net"},"version":"0.13.0"},"paths":{"/v1/auth/nonce":{"get":{"tags":["Sign-in"],"summary":"Nonce","description":"Start a sign-in: a fresh, short-lived nonce and the message fields to sign.\n\nWith ``pair`` (a phone pairing), the statement names the pairing's confirmation code, and ``/verify`` only\naccepts that exact statement for that pairing.\n\n:param request: The incoming request.\n:param pair: The phone pairing id, when signing in on a phone for a desktop extension.\n:return: The sign-in input.","operationId":"nonce_v1_auth_nonce_get","parameters":[{"name":"pair","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/verify":{"post":{"tags":["Sign-in"],"summary":"Verify","description":"Finish a sign-in: check the signed message and return a session token.\n\nThe signature only proves control of the wallet; it grants no spending rights. A new wallet starts at\nzero checks.\n\n:param body: The signed message.\n:param request: The incoming request.\n:return: The session.\n:raises UnauthorizedError: If the message or signature is not acceptable.","operationId":"verify_v1_auth_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/pair":{"post":{"tags":["Sign-in"],"summary":"Start Pairing","description":"Start a phone sign-in for the extension: a pairing id, its confirmation code and the URL to open on the phone.\n\nThe pairing lives five minutes in memory. The extension shows ``connect_url`` as a QR code and the code next to\nit, then polls ``GET /v1/auth/pair/{pair_id}``.\n\n:param request: The incoming request.\n:return: The pairing.\n:raises TooManyRequestsError: If this visitor started too many pairings (or the server holds too many).","operationId":"start_pairing_v1_auth_pair_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PairResponse"}}}}}}},"/v1/auth/pair/{pair_id}/info":{"get":{"tags":["Sign-in"],"summary":"Pairing Info","description":"What the phone shows before signing: the confirmation code to compare with the computer's screen.\n\n:param pair_id: The pairing id from the connect URL.\n:param request: The incoming request.\n:return: The code and the pairing's expiry.","operationId":"pairing_info_v1_auth_pair__pair_id__info_get","parameters":[{"name":"pair_id","in":"path","required":true,"schema":{"type":"string","title":"Pair Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PairInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/pair/{pair_id}":{"get":{"tags":["Sign-in"],"summary":"Collect Pairing","description":"The extension's poll: the session once the phone has signed in (handed over exactly once).\n\n:param pair_id: The pairing id.\n:param request: The incoming request.\n:return: 200 with the session (then the pairing is gone), or 202 while waiting.\n:raises GoneError: If the pairing expired before anyone signed in.\n:raises NotFoundError: If the pairing is unknown (or its session was already collected).","operationId":"collect_pairing_v1_auth_pair__pair_id__get","parameters":[{"name":"pair_id","in":"path","required":true,"schema":{"type":"string","title":"Pair Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"202":{"description":"Not signed in yet"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/challenge":{"get":{"tags":["API keys"],"summary":"Challenge","description":"A proof-of-work challenge for ``POST /v1/keys``: a few seconds of hashing in a browser, used once.\n\n:param request: The incoming request.\n:return: The challenge.","operationId":"challenge_v1_keys_challenge_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeResponse"}}}}}}},"/v1/keys":{"post":{"tags":["API keys"],"summary":"Create Key","description":"Create an empty API key with a solved challenge; a few per visitor network per day.\n\n:param body: The solved challenge.\n:param request: The incoming request.\n:return: The key and recovery code, shown this once.\n:raises BadRequestError: If the challenge is invalid, expired, used or unsolved.\n:raises TooManyRequestsError: If this network created too many keys today.","operationId":"create_key_v1_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/recover":{"post":{"tags":["API keys"],"summary":"Recover Key","description":"Replace a lost key: a new key and a new recovery code, the same id and balance. The old key and code stop working.\n\n:param body: The recovery code.\n:param request: The incoming request.\n:return: The new key and recovery code, shown this once.\n:raises TooManyRequestsError: If this network tried too many recoveries today.\n:raises UnauthorizedError: If the code is not (any longer) valid.","operationId":"recover_key_v1_keys_recover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/move-free-checks":{"post":{"tags":["API keys"],"summary":"Move Free Checks","description":"Move this pass's free checks to another pass: the extension does it when it switches to a pass its user bought.\n\nOnly free checks move (a balance never does), and only from the pass that authenticates the request\n(``Authorization: Bearer ufk_…``).\n\n:param body: The other pass.\n:param request: The incoming request.\n:param account: The account (injected by require_account).\n:return: How many moved.\n:raises BadRequestError: For a wallet's session, or a malformed pass id.","operationId":"move_free_checks_v1_keys_move_free_checks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveFreeChecksRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveFreeChecksResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/phone-qr":{"get":{"tags":["API keys"],"summary":"Phone Qr","description":"A QR code that puts this key on a phone: it opens the link checker (``/check``) signed in with it.\n\nFor a shopper who bought checks in one browser and wants them in the phone app. The code holds\n``<site>/check#pass=<key>``: the key is in the fragment, which a browser never sends anywhere; ``/check`` reads it,\nkeeps it like a pasted key and clears the address bar. Only for an API key (send it as ``Authorization: Bearer``);\nanyone who scans the code can use the key's checks, so pages show it only on request.\n\n:param request: The incoming request (its ``Authorization`` header is the key).\n:param account: The account (injected by require_account).\n:return: The SVG, never cached.\n:raises BadRequestError: For a wallet's session: a wallet signs in on the phone itself.","operationId":"phone_qr_v1_keys_phone_qr_get","responses":{"200":{"description":"The QR code.","content":{"image/svg+xml":{}}}}}},"/v1/pricing":{"get":{"tags":["Credits"],"summary":"Get Pricing","description":"The price of a check and everything derived from it.\n\nThe x402 tiers, the packs (by card in dollars and euros, and the lower crypto price), which countries pay by card\nin euros and which have a local payment method, the suggested country and its card currency, the VAT rules for\ncrypto, exact USDC amounts and a live SOL quote.\n\n:param request: The incoming request.\n:param response: The response (marked uncacheable: it carries the visitor's likely country).\n:return: The price list.","operationId":"get_pricing_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Pricing V1 Pricing Get"}}}}}}},"/v1/credits":{"get":{"tags":["Credits"],"summary":"Get Balance","description":"The balance of the signed-in wallet or the API key.\n\n:param request: The incoming request.\n:param address: The account (injected by require_account).\n:return: The balance, how many analyses it covers, and whether an invite can still be redeemed onto it.","operationId":"get_balance_v1_credits_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsResponse"}}}}}}},"/v1/credits/purchase-tx":{"post":{"tags":["Credits"],"summary":"Purchase Tx","description":"Build the unsigned SOL or USDC transfer that buys a pack of credits; the buyer's wallet signs and sends it.\n\nThe pack costs its crypto price plus the VAT of the buyer's country (see ``vat`` in ``/v1/pricing``); the\ntransaction's memo names the stored quote. Credits arrive once the transfer is finalized (about 15–30 seconds):\nwhat arrived, minus its VAT, credited to the paying wallet unless ``beneficiary`` or ``key_id`` says otherwise.\nNo sign-in needed: anyone may fund any wallet or API key.\n\n:param body: Which pack, for whom, paid how, from where.\n:param request: The incoming request.\n:return: The transaction (base64), a Solana Pay link for phone wallets, and the price breakdown.","operationId":"purchase_tx_v1_credits_purchase_tx_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/quotes/{quote_id}":{"get":{"tags":["Credits"],"summary":"Quote Status","description":"Whether a purchase has been paid: for the checkout to show when the checks have arrived, and its invites once.\n\nNo sign-in: the quote's id (from ``purchase-tx`` or the QR code's ``X-Unfret-Quote`` header) is random, so only\nwhoever started the purchase knows it until the payment's memo puts it on chain, which shows as much already.\nSays nothing about who pays or who gets the checks. Quotes are deleted a day after they expire (404 then). The\ninvite codes need the purchase's claim token too (``X-Unfret-Claim``), which never goes on chain; the first\nresponse that carries it after payment returns them, and wipes them.\n\n:param request: The incoming request.\n:param response: The response (marked uncacheable: it changes once paid).\n:param quote_id: The quote's id.\n:param x_unfret_claim: The purchase's claim token (from ``purchase-tx`` or the QR code's ``X-Unfret-Claim``).\n:return: Paid or not, and the pack size.\n:raises ServiceUnavailableError: Without a database.\n:raises UnknownQuoteError: For an unknown, expired or malformed id.","operationId":"quote_status_v1_credits_quotes__quote_id__get","parameters":[{"name":"quote_id","in":"path","required":true,"schema":{"type":"string","title":"Quote Id"}},{"name":"x-unfret-claim","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"X-Unfret-Claim"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/solana-pay.svg":{"get":{"tags":["Credits"],"summary":"Solana Pay Qr","description":"The Solana Pay request for a pack as a QR code, for paying from a phone wallet.\n\nThe price (VAT included) and its breakdown are in the ``X-Unfret-Total-Usd`` and ``X-Unfret-Vat-Rate``\nheaders; the quote's id, to poll ``/v1/credits/quotes/{quote_id}`` with, in ``X-Unfret-Quote``, and the claim\ntoken that collects the pack's invites with that poll in ``X-Unfret-Claim``; the Solana Pay link itself (to open\na wallet app on the same phone) in ``X-Unfret-Pay-Url``.\n\n:param request: The incoming request.\n:param checks: The pack size.\n:param country: The buyer's country (ISO 3166 alpha-2), for VAT.\n:param currency: ``SOL`` or ``USDC``.\n:param beneficiary: The wallet to credit; without it the paying wallet is credited.\n:param key_id: The API key to credit instead.\n:param code: A bonus or affiliate code, as for ``purchase-tx``.\n:return: An SVG image.","operationId":"solana_pay_qr_v1_credits_solana_pay_svg_get","parameters":[{"name":"checks","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Checks"}},{"name":"country","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":2,"title":"Country"}},{"name":"currency","in":"query","required":false,"schema":{"enum":["SOL","USDC"],"type":"string","default":"SOL","title":"Currency"}},{"name":"beneficiary","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Beneficiary"}},{"name":"key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Key Id"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Code"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/schema/page-facts":{"get":{"tags":["Credits"],"summary":"Page Facts Schema","description":"The JSON schema of ``PageFacts``, for clients (the browser extension) that extract facts themselves.\n\n:return: The schema.","operationId":"page_facts_schema_v1_schema_page_facts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Page Facts Schema V1 Schema Page Facts Get"}}}}}}},"/v1/credits/fiat-checkout":{"post":{"tags":["Credits"],"summary":"Fiat Checkout","description":"Start a card (or other fiat) payment for a pack that tops up an API key, at the provider's hosted checkout.\n\nThe provider is the seller: it handles the buyer's details, invoice and sales tax/VAT; this service only learns\nthat the key was paid for. Credited the pack's value when the provider's webhook confirms the payment.\n\nIn euros for ``currency: \"eur\"`` (by default for visitors from the euro area), in dollars otherwise. A local\npayment method (``payment_method``, e.g. ``wero``) is a checkout in its currency with its billing country\nprefilled, which is what makes the provider show it. Should the provider refuse a euro checkout (e.g. a product\nwithout its euro price yet), the buyer gets the dollar card checkout instead of none; ``currency`` and\n``payment_method`` in the response say which it is.\n\n:param body: The key, the pack, the currency and the payment method.\n:param request: The incoming request.\n:return: The checkout URL.\n:raises ServiceUnavailableError: While no fiat provider is configured, or it can't start a checkout.\n:raises BadRequestError: For euros while euro prices are off, or a method in another currency than asked for.","operationId":"fiat_checkout_v1_credits_fiat_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatCheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/fiat-checkouts/{checkout_id}":{"get":{"tags":["Credits"],"summary":"Fiat Checkout Status","description":"Whether a card checkout has been paid, and the pack's invite codes once: for the checkout page on the way back.\n\nNeeds the checkout's claim token (``X-Unfret-Claim``, from ``fiat-checkout``): the provider knows the checkout's\nid, but never the token. The first response after payment returns the codes and wipes them. 404 for an unknown\ncheckout, a wrong or missing token, or one older than a month.\n\n:param request: The incoming request.\n:param response: The response (marked uncacheable: it changes once paid).\n:param checkout_id: The checkout's id (from ``fiat-checkout``).\n:param x_unfret_claim: The checkout's claim token.\n:return: Paid or not, the pack size, and the invites the first time.\n:raises ServiceUnavailableError: While card payments are off.\n:raises UnknownCheckoutError: For an unknown checkout or a wrong or missing claim token.","operationId":"fiat_checkout_status_v1_credits_fiat_checkouts__checkout_id__get","parameters":[{"name":"checkout_id","in":"path","required":true,"schema":{"type":"string","title":"Checkout Id"}},{"name":"x-unfret-claim","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"X-Unfret-Claim"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatCheckoutStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/fiat-checkouts/{checkout_id}/pass":{"post":{"tags":["Credits"],"summary":"Fiat Checkout Pass","description":"Pick up a card purchase in another browser: a fresh pass (API key) for the key it paid for, and its invites.\n\nFor a buyer whose bank app or phone brought them back to a browser without the pass that was made for the\npurchase. The provider's return link names the checkout (``/checkout?paid=1&checkout=<id>``). Allowed once,\nwithin 24 hours of the payment, and only while the browser that paid hasn't picked the purchase up itself (a\nstatus poll with its claim token after payment); the key is rotated: a new key and recovery code, the same id\nand balance, and the old key stops working. Only for a pass made for the purchase: a top-up of a pass that had\nchecks before (or got some since, from a code or another card order) is never rotated from here.\n\nRefusals: 404 ``UNKNOWN_CHECKOUT``; 409 ``CHECKOUT_NOT_PAID`` (not confirmed yet: retry after a few seconds);\n409 ``CHECKOUT_TOPPED_UP`` (the checks went to a pass in use: nothing to collect here); 409\n``CHECKOUT_COLLECTED`` (picked up already); 410 ``CHECKOUT_EXPIRED``; 429 (too many attempts from here).\n\n:param request: The incoming request.\n:param response: The response (marked uncacheable).\n:param checkout_id: The checkout's id, from the return link.\n:return: The new pass, shown this once.\n:raises ServiceUnavailableError: While card payments are off.\n:raises TooManyRequestsError: If this network tried too many times today.\n:raises UnknownCheckoutError: For an unknown checkout.\n:raises CheckoutNotPaidError: While the payment isn't confirmed.\n:raises CheckoutToppedUpError: When the purchase topped up a pass in use.\n:raises CheckoutCollectedError: When the purchase was picked up already.\n:raises CheckoutExpiredError: After the window.","operationId":"fiat_checkout_pass_v1_credits_fiat_checkouts__checkout_id__pass_post","parameters":[{"name":"checkout_id","in":"path","required":true,"schema":{"type":"string","title":"Checkout Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReissuedPassResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/invites/redeem":{"post":{"tags":["Credits"],"summary":"Redeem","description":"Redeem an invite for the signed-in wallet or the API key: it adds ``invite_checks`` checks (``/v1/pricing``).\n\nThe code is a gift code that came with a pack (``ufi_…``): any account may redeem it, new or in use, except the\none whose purchase issued it; each code works once, and an account redeems one a calendar month (UTC). The account\nkeeps only the fact that it redeemed one and the month of the latest (not which). Intro codes (``FRIENDS``) are\nretired: they answer 410 ``INVITE_ENDED``. Refusals: 400 ``INVALID_INVITE`` (not a code), 404 ``UNKNOWN_INVITE``,\n409 ``INVITE_USED``, 403 ``INVITE_OWN_PACK`` (it came with this account's own pack: give it to a friend), 429\n``INVITE_MONTHLY_LIMIT`` (this account already redeemed a gift code this month; the code stays unused, and\n``metadata.next_month`` is the day it can again), 410 ``INVITE_ENDED``; while intro codes are on again, also 403\n``INVITE_NOT_FOR_THIS_ACCOUNT`` (an intro code on an account that has had checks) and 429 ``INTRO_DAILY_CAP``;\n429 ``TOO_MANY_REQUESTS`` (too many codes tried from one visitor network in ten minutes).\n\n:param body: The code.\n:param request: The incoming request.\n:param account: The redeeming account (injected by require_account).\n:return: What was added and the new balance.\n:raises ServiceUnavailableError: Without a database.\n:raises TooManyRequestsError: Over the redemptions allowed from this visitor network.","operationId":"redeem_v1_invites_redeem_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedeemRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedeemResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/codes/check":{"post":{"tags":["Credits"],"summary":"Check Code","description":"What a bonus or affiliate code gives, so the checkout can show it before the buyer pays.\n\nPass the code as ``code`` to ``/v1/credits/fiat-checkout`` or ``/v1/credits/purchase-tx`` to use it: one code per\npurchase. 404 ``INVALID_CODE`` for any code that can't be used (unknown, ended, used up: one answer for all);\n429 after too many tries from one network in a day.\n\n:param body: The code.\n:param request: The incoming request.\n:return: The offer.\n:raises InvalidCodeError: If the code can't be used.","operationId":"check_code_v1_credits_codes_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeCheckResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affiliates/attribute":{"post":{"tags":["Credits"],"summary":"Attribute","description":"Count the calling pass for the affiliate whose link brought its user (``unfret.net/?ref=CODE``).\n\nFor a page or app that holds a pass made without the code: the browser extension makes its pass on install, and\nthe welcome page relays the code the site kept. Only a pass that has never bought checks, and only once: the first\naffiliate stays. Nothing is stored but the pass, the affiliate and the time.\n\n:param body: The code.\n:param request: The incoming request.\n:param account: The pass (``Authorization: Bearer ufk_…``).\n:return: What happened.","operationId":"attribute_v1_affiliates_attribute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affiliates/stats":{"get":{"tags":["Credits"],"summary":"Stats","description":"An affiliate's numbers per month, for the stats page their secret link opens (``/affiliates/stats#ufa_…``).\n\nThe token travels in the link's fragment (never sent to a server by a browser) and from the page in the\n``X-Unfret-Stats`` header; the operator can replace or revoke it. 404 ``UNKNOWN_STATS_LINK`` otherwise.\n\n:param request: The incoming request.\n:param response: The response (never cached).\n:param x_unfret_stats: The token.\n:return: The numbers.\n:raises NotFoundError: For an unknown or revoked token.","operationId":"stats_v1_affiliates_stats_get","parameters":[{"name":"x-unfret-stats","in":"header","required":false,"schema":{"type":"string","maxLength":100,"description":"The token from your stats link (ufa_…).","default":"","title":"X-Unfret-Stats"},"description":"The token from your stats link (ufa_…)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/analyze":{"post":{"tags":["Analyze"],"summary":"Analyze Page","description":"Analyse a product web page for legitimacy using the LangGraph analysis pipeline, paid from the account's credits.\n\nPasses the page (client-supplied facts and/or HTML or cleaned text) through the graph, which extracts the\nfacts, runs the cheap skills in parallel, lets the triage decide on expensive ones, then synthesises a\nreliability score, an explanation and the shopper verdict (in English). The analysis\nprice is taken from the balance up front and refunded when the page can't be analysed (score -1) or the\nanalysis fails. The same input analysed again within the hour is served from an in-memory cache and costs a\ncheck like a fresh analysis (without one, the usual 402 or 429), except for the account that already paid for\nthat page within the hour, which gets it again free of charge. Nothing about the page or the result is stored;\nthe ``report_token`` lets the caller report a wrong result later (``POST /v1/reports``), sharing the page only\nthen and only with their consent; the ``share_token`` lets them make the verdict public as a link\n(``POST /v1/shares``, without any account).\n\nA request with only a ``url`` has the server fetch the page first (the web link checker). A page it can't check\nthat way is answered with a free 422: ``PAGE_UNAVAILABLE`` (couldn't be fetched), ``PAGE_BLOCKED`` (the shop\nrefuses automatic visitors, or answered with a bot check), ``PAGE_TOO_THIN`` (an empty shell that needs a\nbrowser) or ``INVALID_URL``.\n\nThe caller is a wallet's session (``Authorization: Bearer <session token>``) or an API key (``Bearer ufk_…``).\nA pass's free checks are used before its balance. Once today's free deep checks are all used (by everyone), a\ncheck that only free checks could pay for is refused with 429 ``FREE_CHECKS_PAUSED`` (until 00:00 UTC).\n``\"tier\": \"quick\"`` runs the rules-only quick check instead: free for everyone, with or without\n``Authorization``, never charged, a few a minute.\n\n:param body: The request body containing the page content and flags.\n:param request: The FastAPI request (used to access the compiled graph).\n:param account: The account (injected by optional_account), or ``None`` without ``Authorization`` (only a quick\n    check may do without one).\n:return: Reliability score (0–100), explanation, verdict, the scorer's assessment, the balance left, a report\n    token and a share token.\n:raises InternalServerError: If the graph fails.\n:raises GatewayTimeoutError: If the analysis takes longer than ``analysis_timeout_s``.\n:raises asyncio.CancelledError: If the client hung up (after the refund).","operationId":"analyze_page_v1_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/analyze/stream":{"post":{"tags":["Analyze"],"summary":"Analyze Page Stream","description":"Analyse a page like ``POST /v1/analyze``, streaming progress as server-sent events while skills finish.\n\nEvents: one ``step`` per finished node (``{\"skill\", \"findings\"}`` with the finding types, plus ``page_type``\nonce classified), then a final ``result`` (the ``POST /v1/analyze`` body, with all the evidence) or ``error``.\nCharged like ``POST /v1/analyze`` (a cache hit's result comes at once, charged as there), refunded on ``error``,\na score of -1, or when the client hangs up before the analysis finished. A finished result is cached first, so a\nclient that lost the connection gets it again for free by repeating the request with the same account. A\nURL-only request fetches the page before the stream starts; a page that can't be checked is a free 422 (no\nstream), as for ``POST /v1/analyze``.\nThe free tier and ``\"tier\": \"quick\"`` work as for ``POST /v1/analyze``.\n\n:param body: The request body containing the page content and flags.\n:param request: The FastAPI request (used to access the compiled graph).\n:param account: The account (injected by optional_account), or ``None`` without ``Authorization``.\n:return: A ``text/event-stream`` response.","operationId":"analyze_page_stream_v1_analyze_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/reports":{"post":{"tags":["Reports"],"summary":"Report","description":"Report that a result is wrong. With ``consent``, this one check's page data is shared for review.\n\nSend back the ``report_token`` from the result with the request and explanation exactly as they were, so the\nreport provably concerns a check this account got (for a URL-only check, the page is fetched again now).\nPersonal details are scrubbed before anything is stored. A page already in the queue counts the report as\nconfirmation; a page reviewed recently is ``already_known``. Once a person has labelled the page, the first\nreporter gets free checks if the score was off: 5 when it was 30+ points outside the label's zone, 1 when 10-29.\nLimits: 15 reports per account per month, one per page. A queued report gets an automatic second opinion (a\nproposed label for the reviewer, never a label by itself).\n\n:param body: The report.\n:param request: The incoming request.\n:param account: The reporting account (injected by require_account).\n:return: The outcome.\n:raises ServiceUnavailableError: If reports are off (no session secret) or the queue is full.","operationId":"report_v1_reports_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/check":{"post":{"tags":["x402"],"summary":"Check","description":"Check a store or product page for scam, dropshipping and dark-pattern signals; paid per call over x402.\n\nRetrying with the same payment returns the same answer (for 15 minutes) and is never charged twice. Or send an\nUnfret pass as ``Authorization: Bearer ufk_…`` instead of paying: charged like ``POST /v1/analyze`` (a deep check\nuses one of the pass's checks, free ones first; a quick check is free), with the same verdict plus ``charged``,\n``free_check``, ``balance_usd_micros`` and ``free_checks_left``. Without a payment or a pass the answer is the 402,\nwhatever the body; the body is validated (422) only with one.\n\n:param body: URL, optional page HTML, tier and policy.\n:param request: The incoming request (payment header or pass, app state).\n:return: The verdict, or an x402 payment-required / error response.","operationId":"check_v1_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/unfret__x402__verdict__Verdict"}}}},"401":{"description":"Not a valid Unfret pass (only with Authorization)"},"402":{"description":"Payment required (x402), or the pass has no checks left"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"0.2"},"protocols":[{"x402":{}}]}}},"/v1/health":{"get":{"tags":["Health"],"summary":"Health","description":"Liveness probe. Always returns 200 while the process is serving requests.\n\n:return: Healthy response with the running version, the commit it was built from and the scorers' versions.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Healthy"}}}}}}},"/v1/health/ready":{"get":{"tags":["Health"],"summary":"Ready","description":"Readiness probe. Returns 200 only while the database answers, so a deploy can wait for it.\n\nAlso reports whether x402 payments and card top-ups are available and how many alerts are raised; with the\noperator token (``Authorization: Bearer``), the hot wallet's balances and the alerts themselves. A low balance or\na compromise signal pauses payments (``/v1/check`` answers 503) but never fails readiness: the rest of the API\nkeeps serving.\n\n:param request: The FastAPI request (used to access the DB pool).\n:return: Healthy response with the running version and commit.\n:raises ServiceUnavailableError: If the database pool is missing or the query fails.","operationId":"ready_v1_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Healthy"}}}}}}},"/v1/shares/preview":{"post":{"tags":["Shares"],"summary":"Preview Share","description":"Exactly what ``POST /v1/shares`` would make public, without storing anything. Send it without Authorization.\n\n:param body: The share token, the checked url and the result.\n:param request: The incoming request.\n:return: The public fields and the notice to show the sharer.\n:raises TooManyRequestsError: Over 30 previews a minute from one visitor network.","operationId":"preview_share_v1_shares_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharePreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shares":{"post":{"tags":["Shares"],"summary":"Create Share","description":"Make a result public as a link: ``/r/<id>``, for 90 days. Send it without Authorization; it names no account.\n\nThe token must match the url and the result exactly (a share can only show a verdict Unfret gave for that page)\nand be under 7 days old. What is stored is what the preview shows: the verdict in public wording (no\nscore, never \"scam\" or \"fraud\"), the product's title and link, the shop and the day of the check; no quotes from\nthe page and nothing about who checked. A check that included checkout_content can't be shared. 20 shares per\nvisitor network per day.\n\n:param body: The share token, the checked url and the result.\n:param request: The incoming request.\n:return: The id, the link and the delete code (shown this once).\n:raises TooManyRequestsError: Over today's limit.","operationId":"create_share_v1_shares_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedShare"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shares/{share_id}":{"get":{"tags":["Shares"],"summary":"Get Share","description":"A shared result: what a shopper's check of a product page showed that day.\n\n:param share_id: The share.\n:param request: The incoming request.\n:return: The shared result (404 once deleted, expired or hidden after an objection).","operationId":"get_share_v1_shares__share_id__get","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"string","title":"Share Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Shares"],"summary":"Delete Share","description":"Delete a shared result with its delete code (X-Delete-Code), for good.\n\n:param share_id: The share.\n:param request: The incoming request.\n:param x_delete_code: The delete code shown when it was shared.\n:return: 204.\n:raises BadRequestError: Without the code.\n:raises ForbiddenError: With a wrong code.\n:raises NotFoundError: For no such share.","operationId":"delete_share_v1_shares__share_id__delete","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"string","title":"Share Id"}},{"name":"x-delete-code","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"The delete code.","title":"X-Delete-Code"},"description":"The delete code."}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shares/{share_id}/object":{"post":{"tags":["Shares"],"summary":"Object To Share","description":"Object to a shared result (a shop owner): it is hidden at once, and Unfret reviews it.\n\n:param share_id: The share.\n:param body: Why, optionally.\n:param request: The incoming request.\n:return: ``{\"hidden\": true}``.\n:raises NotFoundError: For no such (visible) share.\n:raises TooManyRequestsError: Over today's limit.","operationId":"object_to_share_v1_shares__share_id__object_post","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"string","title":"Share Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Objection"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Object To Share V1 Shares  Share Id  Object Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/objections":{"post":{"tags":["Shop owners"],"summary":"Send Objection","description":"Object to a result, ask for a correction, or ask Unfret to remove what it keeps about a site or contact detail.\n\nNo sign-in. Stored as sent (the site without anything after ``?`` or ``#``), with the day; no IP address or time.\nDeleted once handled, or after 90 days. 5 requests per visitor network per day.\n\n:param body: The request.\n:param request: The incoming request.\n:return: That it was received.\n:raises TooManyRequestsError: Over today's limit.\n:raises ServiceUnavailableError: Without a database, or with a full queue.\n:raises ObjectionRefusedError: When the site or the reply address isn't one.","operationId":"send_objection_v1_objections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectionRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectionReceived"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/images/{print_id}/thumbnail.jpg":{"get":{"tags":["Images"],"summary":"Thumbnail","description":"A small JPEG of a photo in the image index (the thumbnails in photo findings point here).\n\n:param request: The incoming request (its visitor network, for the limit).\n:param print_id: The index row, from a finding's thumbnail URL.\n:return: The JPEG, cacheable for a day.\n:raises HTTPException: 404 for an unknown row or a photo that is gone.\n:raises TooManyRequestsError: Over the thumbnails allowed from this visitor network in a minute.","operationId":"thumbnail_v1_images__print_id__thumbnail_jpg_get","parameters":[{"name":"print_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"title":"Print Id"}}],"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnalyzeRequest":{"properties":{"page_content":{"anyOf":[{"type":"string","maxLength":2097152,"minLength":1},{"type":"null"}],"title":"Page Content","description":"Raw HTML, or the page's cleaned main text when page_facts is supplied."},"url":{"type":"string","title":"Url","description":"URL of the product page. Sent alone (no page_content or page_facts), the server fetches it.","default":""},"flags":{"items":{"type":"string"},"type":"array","title":"Flags","description":"Names of optional skills to activate in addition to the default set."},"page_facts":{"anyOf":[{"$ref":"#/components/schemas/PageFacts"},{"type":"null"}],"description":"Facts extracted from the rendered page (e.g. by the browser extension). When absent, the server extracts them from page_content."},"checkout_content":{"anyOf":[{"type":"string","maxLength":2097152},{"type":"null"}],"title":"Checkout Content","description":"HTML of the checkout page for this product, if available, to detect fees added at checkout."},"tier":{"type":"string","enum":["deep","quick"],"title":"Tier","description":"deep (the default): the full analysis, which uses a check. quick: rule-based checks of the page itself only (no LLM, no lookups elsewhere; product pages), free for everyone and never charged.","default":"deep"}},"type":"object","title":"AnalyzeRequest","description":"Request body for the analyze endpoint.\n\nUsually the page itself (``page_content`` and/or ``page_facts``). A request with only a ``url`` has the server\nfetch the page: one it can't read (an error, a bot check, a page that needs a browser) is refused before any\ncharge."},"AnalyzeResponse":{"properties":{"score":{"type":"integer","maximum":100.0,"minimum":-1.0,"title":"Score","description":"Reliability score: 0 (scam) → 100 (legitimate); -1 = not analysed."},"explanation":{"type":"string","title":"Explanation","description":"One-line explanation of the score."},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type","description":"What kind of page was checked: aggregate_listing (a product on a marketplace), storefront (a shop's own product page), p2p_listing (a private person's ad), service_listing (a service provider on a platform), service_site (a service company's own site), article or non_product (not analysed). The same value the stream's classify step carries; new values may be added."},"assessment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Assessment","description":"The trained scorer's risk_score, confidence, weighted flags and model_version."},"balance_usd_micros":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Balance Usd Micros","description":"The account's balance after this analysis, in micro-dollars (1 USD = 1,000,000)."},"balance_lamports":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Balance Lamports","description":"Deprecated alias of balance_usd_micros (same value; the name predates dollar prices). Kept for extension versions up to 0.5.0.","deprecated":true},"charged":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Charged","description":"Whether this analysis used a check: false for pages that couldn't be analysed (score -1), quick checks, and a result this account already paid for within the hour, served again from the cache. Any other result from the cache uses a check like a fresh analysis."},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier","description":"Which check this was: deep (the full analysis) or quick (rules only, free)."},"free_check":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Free Check","description":"True when this check was one of the free ones (a pass's, or a day's without one)."},"report_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Token","description":"Pass to POST /v1/reports to report this result as wrong (within 7 days, by the same account), for a quick check as for a deep one. Absent for pages that couldn't be analysed and without an account."},"verdict":{"anyOf":[{"$ref":"#/components/schemas/unfret__shopper__Verdict"},{"type":"null"}],"description":"For shoppers: the band in words, a headline and up to three plain reasons, in English."},"share_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Token","description":"Pass to POST /v1/shares (without Authorization) with the url and this result to make the verdict public as a link (within 7 days; it names no account). Absent for pages that couldn't be analysed. A check that included checkout_content can't be shared."}},"type":"object","required":["score","explanation"],"title":"AnalyzeResponse","description":"Response body for the analyze endpoint."},"AttributeRequest":{"properties":{"code":{"type":"string","maxLength":40,"title":"Code"}},"type":"object","required":["code"],"title":"AttributeRequest","description":"The affiliate code an Unfret page kept from a ``?ref=`` link."},"AttributeResponse":{"properties":{"status":{"type":"string","enum":["attributed","already","not_eligible","invalid"],"title":"Status","description":"attributed; already (it came through an affiliate before: the first one stays); not_eligible (a wallet, or a pass that has bought checks before); invalid (no such affiliate code, or it ended)."}},"type":"object","required":["status"],"title":"AttributeResponse","description":"Whether the pass now counts for the code's affiliate."},"Balance":{"properties":{"payable":{"type":"integer","title":"Payable","description":"Commission past its 30-day hold, less what was paid; below zero after a refund that came after a payout (the next payouts make up for it)."},"held":{"type":"integer","title":"Held","description":"Commission still in its 30-day hold (the refund window)."},"due":{"type":"integer","title":"Due","description":"What the next payout pays: the payable amount once it reaches the minimum."},"carried_over":{"type":"integer","title":"Carried Over","description":"What waits for a later payout (below the minimum, or below zero)."}},"type":"object","required":["payable","held","due","carried_over"],"title":"Balance","description":"An affiliate's balance in one currency, in cents."},"ChallengeResponse":{"properties":{"challenge":{"type":"string","title":"Challenge"},"bits":{"type":"integer","title":"Bits","description":"Find a solution with SHA-256(challenge + ':' + solution) starting with this many zero bits (solution: at most 32 characters, e.g. a decimal counter)."},"expires_at":{"type":"number","title":"Expires At"}},"type":"object","required":["challenge","bits","expires_at"],"title":"ChallengeResponse","description":"A proof-of-work challenge for creating a key."},"CheckItem":{"properties":{"key":{"type":"string","title":"Key","description":"who, product, reviews, prices, tricks (shops); seller, price, photos, payment, text (ads); company, location, reviews, terms, photos (service providers)."},"label":{"type":"string","title":"Label","description":"The area in words: \"Who's behind the shop\", \"Reviews\", …"},"status":{"type":"string","enum":["checked","concern","not_checked"],"title":"Status","description":"checked (nothing to note), concern (a reason above is about it) or not_checked (see note)."},"note":{"type":"string","title":"Note","description":"Why it wasn't checked; empty otherwise.","default":""}},"type":"object","required":["key","label","status"],"title":"CheckItem","description":"One line of the result card's \"What we checked\": an area, and whether it was checked."},"CheckRequest":{"properties":{"url":{"type":"string","title":"Url","description":"URL of the store or product page."},"page_content":{"anyOf":[{"type":"string","maxLength":2097152},{"type":"null"}],"title":"Page Content","description":"The page's HTML, if the agent has it (required for marketplaces that block server fetches)."},"tier":{"type":"string","enum":["quick","deep"],"title":"Tier","default":"quick"},"policy":{"type":"string","enum":["strict","balanced","lenient"],"title":"Policy","default":"balanced"}},"type":"object","required":["url"],"title":"CheckRequest","description":"What to check, how deeply, and how cautious the caller wants the action to be."},"Checkbox":{"properties":{"label":{"type":"string","maxLength":300,"title":"Label","default":""},"name":{"type":"string","maxLength":300,"title":"Name","default":""},"checked":{"type":"boolean","title":"Checked","default":false}},"type":"object","title":"Checkbox","description":"A checkbox on the page, e.g. an add-on in a cart or checkout form."},"CodeCheckRequest":{"properties":{"code":{"type":"string","maxLength":40,"title":"Code","description":"The bonus or affiliate code, as typed."}},"type":"object","required":["code"],"title":"CodeCheckRequest","description":"A code a buyer typed (or a link carried)."},"CodeCheckResponse":{"properties":{"code":{"type":"string","title":"Code","description":"The code, as it will be applied (upper case)."},"label":{"type":"string","title":"Label","description":"The offer in a few words, e.g. \"+20% checks\" or \"+20% checks on your first pack\"."},"bonus_pct":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bonus Pct","description":"Percent more checks with the pack, or null."},"first_pack_only":{"type":"boolean","title":"First Pack Only","description":"The bonus is for a pass's first pack only (an affiliate's code), and only on a pass that hasn't bought before."}},"type":"object","required":["code","label","bonus_pct","first_pack_only"],"title":"CodeCheckResponse","description":"What a code gives on a purchase."},"CreateKeyRequest":{"properties":{"challenge":{"type":"string","maxLength":200,"title":"Challenge"},"solution":{"type":"string","maxLength":32,"minLength":1,"title":"Solution"},"free":{"type":"boolean","title":"Free","description":"Ask for the free checks a new pass comes with (the browser extension does on install). Given only while this network hasn't had its share of free passes today; the response's free_checks says how many.","default":false},"developer":{"type":"boolean","title":"Developer","description":"Ask for a developer pass: more free deep checks (developer_free_checks, 20), for building and testing an agent against /v1/check, the MCP server or the clients. One a day per network; past that the pass is made empty. Takes the place of free.","default":false},"ref":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Ref","description":"The affiliate code of the link that brought this visitor (unfret.net/?ref=CODE), kept by the page: the new pass counts for that affiliate. An unknown or ended code is ignored."}},"type":"object","required":["challenge","solution"],"title":"CreateKeyRequest","description":"A solved challenge."},"CreatedShare":{"properties":{"id":{"type":"string","title":"Id"},"link":{"type":"string","title":"Link","description":"The share's page on this site, /r/<id>: the link to pass on."},"delete_code":{"type":"string","title":"Delete Code","description":"Send as X-Delete-Code to DELETE /v1/shares/<id>."},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["id","link","delete_code","expires_at"],"title":"CreatedShare","description":"A new share. The delete code is shown this once and stored only as a hash: keep it to delete the share."},"CreditsResponse":{"properties":{"address":{"type":"string","title":"Address","description":"The account: the wallet's address, or key:<id> for an API key."},"balance_usd_micros":{"type":"integer","title":"Balance Usd Micros","description":"The balance in micro-dollars (1 USD = 1,000,000)."},"checks_remaining":{"type":"integer","title":"Checks Remaining","description":"Checks left: the balance in checks, plus the free checks left."},"balance_lamports":{"type":"integer","title":"Balance Lamports","description":"Deprecated: the same micro-dollar balance under its old name, kept for older clients."},"invite_eligible":{"type":"boolean","title":"Invite Eligible","description":"Whether a gift code (invite) can be redeemed onto this account: always true now, since a gift code works on any account but the one whose pack it came with (POST /v1/invites/redeem says so for that one)."},"free_checks_remaining":{"type":"integer","title":"Free Checks Remaining","description":"Free deep checks left on this pass (included in checks_remaining); 0 for a wallet.","default":0},"free_checks_paused":{"type":"boolean","title":"Free Checks Paused","description":"Today's free deep checks are all used (by everyone): free checks wait until 00:00 UTC, while bought checks and quick checks work.","default":false}},"type":"object","required":["address","balance_usd_micros","checks_remaining","balance_lamports","invite_eligible"],"title":"CreditsResponse","description":"An account's balance."},"DeepCheck":{"properties":{"suggested":{"type":"boolean","title":"Suggested"},"reason":{"type":"string","enum":["on_the_fence","unknown_seller","serious_concerns","known_seller","nothing_to_add"],"title":"Reason","description":"Why (not): on_the_fence (Worth a look, Think twice), unknown_seller (Looks fine, but the quick check can't see who is behind the page); serious_concerns (the advice is already to buy elsewhere), known_seller (a big marketplace's own or the brand's listing), nothing_to_add."},"quiet":{"type":"boolean","title":"Quiet","description":"Show it quietly (Looks fine): as a note, not a call to action.","default":false},"adds":{"items":{"$ref":"#/components/schemas/DeepCheckAdd"},"type":"array","maxItems":3,"title":"Adds","description":"What a deep check adds here."},"text":{"type":"string","title":"Text","description":"\"A deep check also looks at …\" (empty when not suggested).","default":""},"cost":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost","description":"What a deep check would cost this caller, in words: \"Uses 1 of your 3 free deep checks.\", \"Uses 1 check (you have 12).\", \"Deep checks come in packs, from $6.00 for 25.\"; on /v1/check paid with x402, the deep tier's price."},"action":{"anyOf":[{"type":"string","enum":["run_deep","get_checks"]},{"type":"null"}],"title":"Action","description":"run_deep: the caller can run it now (tier deep); get_checks: it needs checks first."},"action_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Label","description":"\"Run a deep check\" or \"Get checks\"."}},"type":"object","required":["suggested","reason"],"title":"DeepCheck","description":"On a quick result only: whether a deep check of the same page is worth suggesting, and what it would add.\n\nWorked out from the quick result alone; it never changes the quick verdict."},"DeepCheckAdd":{"properties":{"key":{"type":"string","title":"Key","description":"shop_age, photo_elsewhere, reviews, brand, price_history, vat_register (shops and marketplace listings); seller_profile, ad_photos, ad_price (ads); provider_profile, service_terms (service platforms)."},"area":{"type":"string","title":"Area","description":"The checklist area it belongs to (a CheckItem key)."},"label":{"type":"string","title":"Label","description":"In words, to follow \"A deep check also looks at\": \"how old this shop is\"."}},"type":"object","required":["key","area","label"],"title":"DeepCheckAdd","description":"One thing a deep check would look at on this page that the quick check left out."},"Email":{"properties":{"address":{"type":"string","maxLength":254,"title":"Address","default":""},"kind":{"type":"string","enum":["own_domain","webmail","other"],"title":"Kind","description":"own_domain (same domain as the page), webmail (Gmail, Hotmail, …) or other.","default":"other"}},"type":"object","title":"Email","description":"An e-mail address the business publishes."},"FiatCheckoutRequest":{"properties":{"key_id":{"type":"string","maxLength":120,"title":"Key Id","description":"The API key's id (or the key itself: only the id is used)."},"checks":{"type":"integer","exclusiveMinimum":0.0,"title":"Checks","description":"The pack: one of the pack sizes in /v1/pricing."},"currency":{"anyOf":[{"type":"string","enum":["usd","eur"]},{"type":"null"}],"title":"Currency","description":"usd (charged the pack's price_usd) or eur (its price_eur; Polar then offers iDEAL | Wero to Dutch buyers once they choose the Netherlands as billing country). Default: /v1/pricing's card_currency for this visitor (eur from the euro area), or the payment method's currency."},"payment_method":{"type":"string","maxLength":32,"title":"Payment Method","description":"card (default: the buyer picks their country on the provider's page), or a local method's id from /v1/pricing's local_payment_methods for the buyer's chosen country (e.g. wero: iDEAL | Wero, a EUR checkout with the Netherlands prefilled as billing country). A local method is charged in its own currency.","default":"card"},"code":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Code","description":"A bonus or affiliate code (POST /v1/credits/codes/check shows what it gives): its bonus checks are added when the order is paid. One code per purchase; the price stays the same."}},"type":"object","required":["key_id","checks"],"title":"FiatCheckoutRequest","description":"Which key to top up with which pack."},"FiatCheckoutResponse":{"properties":{"checkout_url":{"type":"string","title":"Checkout Url"},"provider":{"type":"string","title":"Provider"},"currency":{"type":"string","enum":["usd","eur"],"title":"Currency","description":"The checkout's currency: usd or eur."},"payment_method":{"type":"string","title":"Payment Method","description":"The checkout's method: the one asked for, or card if the provider refused it and the dollar card checkout was made instead."},"checkout_id":{"type":"string","title":"Checkout Id","description":"Poll GET /v1/credits/fiat-checkouts/{checkout_id} (with the claim) for it."},"claim":{"type":"string","title":"Claim","description":"Send as X-Unfret-Claim with that poll: the first one after payment returns the pack's invite codes, once. Keep it in the buyer's browser (e.g. localStorage) across the provider's checkout; it isn't stored and is never sent to the provider."}},"type":"object","required":["checkout_url","provider","currency","payment_method","checkout_id","claim"],"title":"FiatCheckoutResponse","description":"Where to send the buyer, and how to collect the order's invites when they come back."},"FiatCheckoutStatusResponse":{"properties":{"paid":{"type":"boolean","title":"Paid","description":"True once the provider's webhook confirmed the payment and the key was credited."},"checks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checks","description":"The pack size the checkout is for."},"invites":{"items":{"type":"string"},"type":"array","title":"Invites","description":"The pack's invite codes (ufi_...), to give away: returned once, in the first response after payment that carries the purchase's X-Unfret-Claim, then never again (only their hashes are kept). Empty otherwise."},"reissued":{"type":"boolean","title":"Reissued","description":"True when the purchase was picked up in another browser (POST /v1/credits/fiat-checkouts/{checkout_id}/pass): the key this browser made for it was replaced and no longer works.","default":false}},"type":"object","required":["paid","checks"],"title":"FiatCheckoutStatusResponse","description":"Whether a card checkout has been paid, and its invites once."},"Flag":{"properties":{"type":{"type":"string","title":"Type"},"evidence":{"type":"string","title":"Evidence"},"weight":{"type":"number","minimum":0.0,"title":"Weight","description":"How much this signal matters (larger = more; high 1.0, medium 0.6, low 0.3)."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","description":"A short human label for the signal."},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity","description":"high, medium or low."}},"type":"object","required":["type","evidence","weight"],"title":"Flag","description":"One factual signal and how much it contributed."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Healthy":{"properties":{"status":{"type":"string","title":"Status","description":"The status of the health check","default":"healthy"},"version":{"type":"string","title":"Version","description":"The version of the API","default":"0.13.0"},"commit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit","description":"The git commit the running image was built from"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version","description":"The scorer analyses and deep checks run (the open baseline or a retrained one)"},"quick_model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quick Model Version","description":"The scorer the x402 quick tier runs"},"x402":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X402","description":"Pay-per-check status: ok, off, low_balance, …"},"hot_sol_lamports":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hot Sol Lamports","description":"The x402 hot wallet's SOL (fee reserve)"},"hot_wsol_lamports":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hot Wsol Lamports","description":"Received payments not yet swept to cold"},"hot_usdc_units":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hot Usdc Units","description":"Received USDC not yet swept to the cold wallet"},"x402_alerts":{"items":{"type":"string"},"type":"array","title":"X402 Alerts","description":"sweep_failing, fee_reserve_low, … (with the operator token only)"},"x402_alert_count":{"type":"integer","title":"X402 Alert Count","description":"How many x402 alerts are raised","default":0},"x402_base":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X402 Base","description":"Pay-per-check on Base: ok, off, mainnet_refused, …"},"x402_base_alert_count":{"type":"integer","title":"X402 Base Alert Count","description":"How many x402-on-Base alerts are raised","default":0},"x402_base_alerts":{"items":{"type":"string"},"type":"array","title":"X402 Base Alerts","description":"fee_reserve_low, outflow_to_non_cold, … (with the operator token only)"},"base_hot_usdc_units":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Base Hot Usdc Units","description":"USDC on the Base hot wallet, not yet swept to cold (with the operator token only)"},"base_hot_eth_wei":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Base Hot Eth Wei","description":"ETH on the Base hot wallet, for the sweeps' gas (with the operator token only)"},"credits":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credits","description":"Credits door: off, sign_in, ok (purchases on)"},"fiat":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiat","description":"Card top-ups: off, or the provider (polar:production, …)"}},"type":"object","title":"Healthy","description":"Response schema for the health check endpoint."},"KeyResponse":{"properties":{"key_id":{"type":"string","title":"Key Id","description":"The public id: name it to top up the key (memos, checkout)."},"key":{"type":"string","title":"Key","description":"Send as Authorization: Bearer <key>."},"recovery_code":{"type":"string","title":"Recovery Code","description":"Gets a new key (and a new code) with the same balance if the key is lost."},"account":{"type":"string","title":"Account","description":"The ledger account, key:<id>."},"balance_usd_micros":{"type":"integer","title":"Balance Usd Micros"},"free_checks":{"type":"integer","title":"Free Checks","description":"Free deep checks on this pass (spent before its balance).","default":0}},"type":"object","required":["key_id","key","recovery_code","account","balance_usd_micros"],"title":"KeyResponse","description":"A key and its recovery code: shown this once, stored only as hashes. Save both."},"Licence":{"properties":{"number":{"type":"string","maxLength":40,"title":"Number","default":""},"state":{"type":"string","maxLength":2,"title":"State","default":""}},"type":"object","title":"Licence","description":"A (US) licence number the page states, with its state when given (\"CA Lic. #1234567\")."},"Link":{"properties":{"text":{"type":"string","maxLength":300,"title":"Text","default":""},"url":{"type":"string","maxLength":500,"title":"Url","default":""}},"type":"object","title":"Link","description":"A link to another page on the same site."},"ListingDetails":{"properties":{"negotiable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Negotiable"},"bidding":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bidding"},"condition":{"type":"string","maxLength":100,"title":"Condition","default":""},"category":{"type":"string","maxLength":300,"title":"Category","default":""},"listed":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Listed"},"location":{"type":"string","maxLength":300,"title":"Location","default":""},"delivery":{"items":{"type":"string","enum":["shipping","pickup"]},"type":"array","maxItems":2,"title":"Delivery"},"payment_protection":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Payment Protection","description":"The platform's own payment or buyer protection."},"contact_methods":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Contact Methods","description":"Ways to reach the seller the ad text mentions: whatsapp, telegram, phone, email."},"payment_requests":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Payment Requests","description":"Payment the ad text asks for: bank_transfer, payment_link, deposit, gift_card, crypto, money_transfer, payment_app."},"description":{"type":"string","maxLength":5000,"title":"Description","description":"The ad's own text as the seller wrote it (not the platform's), for the check only.","default":""}},"type":"object","title":"ListingDetails","description":"A peer-to-peer ad: the item and the deal as the platform shows them (price: ``PageFacts.price``)."},"MoneyMonth":{"properties":{"net":{"type":"integer","title":"Net","description":"Net revenue of purchases on your passes: after VAT and payment fees."},"commission":{"type":"integer","title":"Commission"},"reversed":{"type":"integer","title":"Reversed","description":"Commission taken back after refunds and chargebacks."},"paid":{"type":"integer","title":"Paid"}},"type":"object","required":["net","commission","reversed","paid"],"title":"MoneyMonth","description":"Amounts in one currency's cents."},"MoveFreeChecksRequest":{"properties":{"to_key_id":{"type":"string","maxLength":100,"title":"To Key Id","description":"The id of the pass to move them to (or the whole pass)."}},"type":"object","required":["to_key_id"],"title":"MoveFreeChecksRequest","description":"Where to put this pass's free checks."},"MoveFreeChecksResponse":{"properties":{"moved":{"type":"integer","title":"Moved","description":"Free checks moved (0 when there were none, or no such pass)."}},"type":"object","required":["moved"],"title":"MoveFreeChecksResponse","description":"What moved."},"NextStep":{"properties":{"type":{"type":"string","title":"Type","description":"What the step is about (the reason it follows from, or the band)."},"text":{"type":"string","title":"Text"}},"type":"object","required":["type","text"],"title":"NextStep","description":"The one thing the card suggests doing next."},"NonceResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"uri":{"type":"string","title":"Uri"},"statement":{"type":"string","title":"Statement"},"nonce":{"type":"string","title":"Nonce"},"issued_at":{"type":"string","title":"Issued At"},"expiration_time":{"type":"string","title":"Expiration Time"},"version":{"type":"string","title":"Version"}},"type":"object","required":["domain","uri","statement","nonce","issued_at","expiration_time","version"],"title":"NonceResponse","description":"The fields a wallet signs (Wallet Standard ``solana:signIn`` input)."},"Objection":{"properties":{"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Why (optional).","default":""}},"type":"object","title":"Objection","description":"A shop owner's objection to a shared result."},"ObjectionReceived":{"properties":{"status":{"type":"string","const":"received","title":"Status","default":"received"},"answer_within_days":{"type":"integer","title":"Answer Within Days","description":"The longest it takes to handle (data requests: one month)."}},"type":"object","required":["answer_within_days"],"title":"ObjectionReceived","description":"The request is in the queue."},"ObjectionRequest":{"properties":{"kind":{"type":"string","enum":["correction","removal","other"],"title":"Kind","description":"correction (a result about the site is wrong), removal (delete what Unfret keeps about the site or a contact detail), other."},"site":{"type":"string","maxLength":500,"minLength":4,"title":"Site","description":"The shop, page or ad it is about: a link or a domain. Anything after ? or # is dropped."},"message":{"type":"string","maxLength":2000,"title":"Message","description":"What is wrong, or which contact details (e-mail, phone, address) to remove.","default":""},"reply_to":{"type":"string","maxLength":254,"title":"Reply To","description":"An e-mail address to answer at (optional; without one Unfret can't reply).","default":""}},"type":"object","required":["kind","site"],"title":"ObjectionRequest","description":"A shop owner's or seller's request."},"PageFacts":{"properties":{"platform":{"type":"string","enum":["amazon","bol.com","walmart","shopify","woocommerce","ebay","marktplaats","2dehands","vinted","craigslist","facebook","werkspot","thumbtack","angi","homeadvisor","checkatrade","taskrabbit","bark","houzz","myhammer","homeguide","generic"],"title":"Platform","default":"generic"},"url":{"type":"string","maxLength":2000,"title":"Url","default":""},"title":{"type":"string","maxLength":2000,"title":"Title","default":""},"brand":{"type":"string","maxLength":300,"title":"Brand","default":""},"seller":{"type":"string","maxLength":300,"title":"Seller","default":""},"seller_rating":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Seller Rating","description":"Positive share in percent."},"ships_from":{"type":"string","maxLength":300,"title":"Ships From","default":""},"price":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Price"},"list_price":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"List Price","description":"Struck-through 'was' / compare-at price."},"currency":{"type":"string","maxLength":8,"title":"Currency","default":""},"date_first_available":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date First Available"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"rating_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Rating Count"},"rating_histogram":{"additionalProperties":{"type":"number"},"type":"object","title":"Rating Histogram","description":"Share of ratings (0–1) per star count 1–5."},"reviews":{"items":{"$ref":"#/components/schemas/Review"},"type":"array","maxItems":100,"title":"Reviews"},"variations":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Variations"},"json_ld":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":20,"title":"Json Ld","description":"Product JSON-LD."},"script_srcs":{"items":{"type":"string"},"type":"array","maxItems":300,"title":"Script Srcs"},"meta":{"additionalProperties":{"type":"string"},"type":"object","title":"Meta"},"markup_names":{"items":{"type":"string"},"type":"array","maxItems":500,"title":"Markup Names","description":"Class names, ids and data-attribute names in the page's markup (names only, never values or text): the traces of a shop's apps when there is no raw HTML (unfret.facts.markup)."},"external_refs":{"items":{"type":"string"},"type":"array","maxItems":200,"title":"External Refs","description":"The other sites the page's elements refer to: host and path for a link, the host alone for anything else; never a query string (unfret.facts.markup)."},"hidden_text":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Hidden Text"},"checkboxes":{"items":{"$ref":"#/components/schemas/Checkbox"},"type":"array","maxItems":100,"title":"Checkboxes"},"timers":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Timers","description":"Countdown elements or scripts."},"fee_mentions":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Fee Mentions"},"vat_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Vat Ids"},"legal_mentions":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Legal Mentions","description":"Imprint, company register and withdrawal-right text."},"copyright_lines":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Copyright Lines","description":"Copyright lines ('© 2026 Acme Outdoor LLC. All rights reserved.'): the keyword and what follows."},"policy_links":{"additionalProperties":{"type":"string"},"type":"object","title":"Policy Links","description":"Kind (refund, terms, privacy, contact, imprint, shipping) to URL."},"image_urls":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Image Urls"},"product_ids":{"additionalProperties":{"type":"string"},"type":"object","title":"Product Ids","description":"Public product IDs by kind: gtin, gtin8/12/13/14, mpn, asin."},"payment_methods":{"items":{"type":"string"},"type":"array","maxItems":30,"title":"Payment Methods","description":"Payment methods the page mentions (paypal, ideal, crypto, …)."},"phones":{"items":{"$ref":"#/components/schemas/Phone"},"type":"array","maxItems":20,"title":"Phones"},"emails":{"items":{"$ref":"#/components/schemas/Email"},"type":"array","maxItems":20,"title":"Emails"},"addresses":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Addresses","description":"Postal addresses from structured data and contact areas."},"founded_claims":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Founded Claims","description":"\"Since 1998\", \"opgericht in 2004\", a foundingDate."},"business_name":{"type":"string","maxLength":300,"title":"Business Name","description":"From Organization/LocalBusiness data.","default":""},"legal_form":{"type":"string","maxLength":20,"title":"Legal Form","description":"BV, VOF, LLC, Inc, GmbH, … as stated.","default":""},"kvk_numbers":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Kvk Numbers","description":"Dutch Chamber of Commerce."},"licences":{"items":{"$ref":"#/components/schemas/Licence"},"type":"array","maxItems":10,"title":"Licences"},"certifications":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Certifications","description":"Licence, insurance and certification claims (snippets)."},"cities_served":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Cities Served"},"internal_links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array","maxItems":100,"title":"Internal Links"},"pricing_terms":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Pricing Terms","description":"Call-out fees, quotes, deposits, hourly rates (snippets)."},"promises":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Promises","description":"\"24/7\", \"within 30 minutes\", same-day (snippets)."},"testimonials":{"items":{"$ref":"#/components/schemas/Testimonial"},"type":"array","maxItems":50,"title":"Testimonials","description":"Testimonials on a service company's own site."},"organization_ld":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":10,"title":"Organization Ld","description":"Organization/LocalBusiness JSON-LD, trimmed."},"seller_profile":{"anyOf":[{"$ref":"#/components/schemas/SellerProfile"},{"type":"null"}]},"listing":{"anyOf":[{"$ref":"#/components/schemas/ListingDetails"},{"type":"null"}]}},"type":"object","title":"PageFacts","description":"Structured facts about one page. Absent facts are ``None`` or empty, never guessed."},"PairInfoResponse":{"properties":{"confirm_code":{"type":"string","title":"Confirm Code"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["confirm_code","expires_at"],"title":"PairInfoResponse","description":"What the phone page shows: the code to compare and when the pairing expires."},"PairResponse":{"properties":{"pair_id":{"type":"string","title":"Pair Id"},"confirm_code":{"type":"string","title":"Confirm Code"},"connect_url":{"type":"string","title":"Connect Url"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["pair_id","confirm_code","connect_url","expires_at"],"title":"PairResponse","description":"A new phone pairing, for the extension to show as a QR code."},"Phone":{"properties":{"number":{"type":"string","maxLength":20,"title":"Number","description":"+ and digits when the country is known, else digits.","default":""},"kind":{"type":"string","enum":["mobile","local","national","toll_free","premium","unknown"],"title":"Kind","description":"mobile, local (geographic), national (non-geographic), toll_free, premium (NL and US numbers).","default":"unknown"},"country":{"type":"string","maxLength":2,"title":"Country","description":"ISO country code from the number, when known.","default":""}},"type":"object","title":"Phone","description":"A phone number the business publishes (``tel:`` links, contact areas, structured data)."},"Positive":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"detail":{"type":"string","title":"Detail"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Where the evidence comes from, in words."}},"type":"object","required":["type","title","detail"],"title":"Positive","description":"Something that looks good, for a shopper."},"PurchaseRequest":{"properties":{"address":{"type":"string","maxLength":64,"title":"Address","description":"The paying wallet (base58), which signs and sends the transfer."},"currency":{"type":"string","enum":["SOL","USDC"],"title":"Currency","description":"Pay in SOL or USDC.","default":"SOL"},"checks":{"type":"integer","exclusiveMinimum":0.0,"title":"Checks","description":"The pack: one of the pack sizes in /v1/pricing."},"country":{"type":"string","maxLength":2,"minLength":2,"title":"Country","description":"The buyer's country (ISO 3166 alpha-2), for VAT. The checkout prefills it from where the request comes from; the buyer can change it."},"beneficiary":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Beneficiary","description":"The wallet that gets the credits (defaults to address), e.g. a member key when a smart-wallet vault pays."},"key_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Key Id","description":"Top up this API key instead (its id, or the key itself: only the id is used)."},"code":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Code","description":"A bonus or affiliate code (POST /v1/credits/codes/check shows what it gives): its bonus checks are added when the payment is credited. One code per purchase; the price stays the same."}},"type":"object","required":["address","checks","country"],"title":"PurchaseRequest","description":"Which pack, for whom, paid how, from where."},"PurchaseResponse":{"properties":{"transaction":{"type":"string","title":"Transaction"},"currency":{"type":"string","enum":["SOL","USDC"],"title":"Currency"},"amount":{"type":"integer","title":"Amount","description":"The amount in the currency's base units (VAT included)."},"lamports":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lamports","description":"The amount for SOL purchases (backward compatible)."},"mint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mint","description":"The token mint for USDC purchases."},"hot_wallet":{"type":"string","title":"Hot Wallet"},"solana_pay_url":{"type":"string","title":"Solana Pay Url"},"checks":{"type":"integer","title":"Checks"},"price":{"$ref":"#/components/schemas/VatBreakdown"},"quote_id":{"type":"string","title":"Quote Id","description":"The purchase's quote: poll GET /v1/credits/quotes/{quote_id} to see it paid."},"claim":{"type":"string","title":"Claim","description":"Send as X-Unfret-Claim when polling the quote: the first poll after payment returns the pack's invite codes, once. Keep it in the buyer's page only; it isn't stored, so it can't be shown again."}},"type":"object","required":["transaction","currency","amount","hot_wallet","solana_pay_url","checks","price","quote_id","claim"],"title":"PurchaseResponse","description":"The unsigned transfer for the buyer's wallet, and the same request as a Solana Pay link."},"QuoteStatusResponse":{"properties":{"paid":{"type":"boolean","title":"Paid","description":"True once a payment naming this quote has been credited."},"checks":{"type":"integer","title":"Checks","description":"The pack size the quote is for."},"invites":{"items":{"type":"string"},"type":"array","title":"Invites","description":"The pack's invite codes (ufi_...), to give away: returned once, in the first response after payment that carries the purchase's X-Unfret-Claim, then never again (only their hashes are kept). Empty otherwise."}},"type":"object","required":["paid","checks"],"title":"QuoteStatusResponse","description":"Whether a purchase's payment has been credited, and its invites once."},"Reason":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"detail":{"type":"string","title":"Detail"},"severity":{"type":"string","enum":["high","medium","low"],"title":"Severity"},"thumbnails":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Thumbnails","description":"Up to three thumbnail URLs of the matching photos."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Where the evidence comes from, in words: \"Domain registry (RDAP)\", \"The page\", …"}},"type":"object","required":["type","title","detail","severity"],"title":"Reason","description":"Something that lowered the score, for a shopper."},"RecoverRequest":{"properties":{"recovery_code":{"type":"string","maxLength":100,"title":"Recovery Code"}},"type":"object","required":["recovery_code"],"title":"RecoverRequest","description":"A recovery code."},"RedeemRequest":{"properties":{"code":{"type":"string","maxLength":100,"title":"Code","description":"The gift code (ufi_…), as given."}},"type":"object","required":["code"],"title":"RedeemRequest","description":"An invite code."},"RedeemResponse":{"properties":{"checks_added":{"type":"integer","title":"Checks Added"},"usd_micros_added":{"type":"integer","title":"Usd Micros Added"},"balance_usd_micros":{"type":"integer","title":"Balance Usd Micros"},"checks_remaining":{"type":"integer","title":"Checks Remaining"}},"type":"object","required":["checks_added","usd_micros_added","balance_usd_micros","checks_remaining"],"title":"RedeemResponse","description":"What the invite added."},"ReissuedPassResponse":{"properties":{"key_id":{"type":"string","title":"Key Id","description":"The key's public id (unchanged)."},"key":{"type":"string","title":"Key","description":"The new key (the pass). Send as Authorization: Bearer <key>."},"recovery_code":{"type":"string","title":"Recovery Code","description":"The new recovery code (the backup code)."},"account":{"type":"string","title":"Account","description":"The ledger account, key:<id>."},"checks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checks","description":"The pack size the checkout paid for."},"checks_remaining":{"type":"integer","title":"Checks Remaining","description":"The key's balance in checks."},"invites":{"items":{"type":"string"},"type":"array","title":"Invites","description":"The pack's invite codes, if not collected yet."}},"type":"object","required":["key_id","key","recovery_code","account","checks","checks_remaining"],"title":"ReissuedPassResponse","description":"A card purchase picked up in another browser: a fresh pass (API key) for it, shown this once."},"ReportRequest":{"properties":{"report_token":{"type":"string","maxLength":600,"title":"Report Token","description":"The report_token from the analysis result."},"reason":{"type":"string","enum":["real_brand","scam","junk","other"],"title":"Reason","description":"What the page really is: real_brand (a genuine product or shop), scam, junk (dropship or low-quality), other."},"consent":{"type":"boolean","const":true,"title":"Consent","description":"Must be true: I share this one check's page facts, page text and result with Unfret for review. Personal details are removed before it is stored; a language model hosted in the EU may read it to suggest a label, and a person decides; once reviewed, it is kept without any link to my account."},"request":{"$ref":"#/components/schemas/AnalyzeRequest","description":"The analysed request, exactly as it was sent."},"explanation":{"type":"string","maxLength":4000,"title":"Explanation","description":"The result's explanation, exactly as it was returned."},"verdict":{"anyOf":[{"$ref":"#/components/schemas/Verdict-Input"},{"type":"null"}],"description":"The result's verdict, as returned."}},"type":"object","required":["report_token","reason","consent","request","explanation"],"title":"ReportRequest","description":"A wrong result, sent back with the check it came from."},"ReportResponse":{"properties":{"status":{"type":"string","enum":["queued","already_reported","already_known"],"title":"Status","description":"queued (in the review queue), already_reported (someone reported this page first: your report counts as confirmation), already_known (reviewed recently)."},"reports_used":{"type":"integer","title":"Reports Used","description":"Reports this account made this month, this one included."},"reports_per_month":{"type":"integer","title":"Reports Per Month"}},"type":"object","required":["status","reports_used","reports_per_month"],"title":"ReportResponse","description":"What happened to the report."},"Review":{"properties":{"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"posted":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted"},"title":{"type":"string","maxLength":300,"title":"Title","default":""},"body":{"type":"string","maxLength":2000,"title":"Body","default":""},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"}},"type":"object","title":"Review","description":"One review as shown on the page."},"Rules":{"properties":{"hold_days":{"type":"integer","title":"Hold Days"},"min_payout_cents":{"type":"integer","title":"Min Payout Cents"}},"type":"object","required":["hold_days","min_payout_cents"],"title":"Rules","description":"How payouts work."},"SameProduct":{"properties":{"title":{"type":"string","title":"Title","description":"\"Looks like the same product, sold elsewhere\"."},"detail":{"type":"string","title":"Detail","description":"Where, and for how much when Unfret has seen its price."},"where":{"type":"string","title":"Where","description":"The other shop's domain, or \"Amazon\" for an Amazon listing."},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"The other shop's registrable domain, when it is a shop."},"others":{"type":"integer","minimum":0.0,"title":"Others","description":"How many more shops show the same photo.","default":0},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","description":"The other listing's price when Unfret has seen it."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO 4217 code of price."},"price_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Text","description":"The price in words: \"$12.99\"."},"price_seen_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Seen On","description":"The day Unfret saw that price (YYYY-MM-DD)."},"brands":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Brands","description":"Other brand names the same photo is sold under there (names only), when Unfret knows them."},"image":{"type":"string","title":"Image","description":"Thumbnail URL of the other listing's photo (this server's image proxy)."},"own_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Own Image","description":"Thumbnail URL of this page's own photo, when the index keeps it."}},"type":"object","required":["title","detail","where","image"],"title":"SameProduct","description":"The same product photo on another shop or listing (Unfret's image index): shown first, with both photos."},"SellerProfile":{"properties":{"seller_type":{"type":"string","enum":["","business","private"],"title":"Seller Type","description":"business or private, as the platform labels them.","default":""},"member_since":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Member Since"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"rating_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Rating Count"},"badges":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Badges","description":"Verified ID, Top seller, …"},"other_listings":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Other Listings"},"response_time":{"type":"string","maxLength":100,"title":"Response Time","default":""},"response_rate":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Response Rate","description":"In percent."},"jobs_completed":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Jobs Completed"},"years_in_business":{"anyOf":[{"type":"integer","maximum":200.0,"minimum":0.0},{"type":"null"}],"title":"Years In Business"}},"type":"object","title":"SellerProfile","description":"The seller (peer-to-peer) or provider (service platform) as the platform shows them: never their name.\n\nUsed during the check only."},"SessionResponse":{"properties":{"token":{"type":"string","title":"Token"},"address":{"type":"string","title":"Address"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["token","address","expires_at"],"title":"SessionResponse","description":"A session for a wallet."},"SharePreview":{"properties":{"title":{"type":"string","title":"Title","description":"The product's title, as the page showed it (or the shop when it had none)."},"host":{"type":"string","title":"Host","description":"The shop or marketplace."},"product_url":{"type":"string","title":"Product Url","description":"The product page (without tracking parameters), linked nofollow."},"checked_on":{"type":"string","format":"date","title":"Checked On","description":"The day of the check; the page may have changed since."},"checked_on_text":{"type":"string","title":"Checked On Text","description":"The same day, in words."},"band":{"type":"string","enum":["reliable","concerns","careful","warning"],"title":"Band"},"label":{"type":"string","title":"Label","description":"What Unfret would tell a shopper about this listing."},"symbol":{"type":"string","title":"Symbol"},"headline":{"type":"string","title":"Headline"},"result":{"additionalProperties":true,"type":"object","title":"Result","description":"verdict (band, label, symbol, headline, reasons, positives) and, with flags, assessment (flags with labels only, confidence, model_version). No score, no quotes from the page."},"notice":{"type":"string","title":"Notice","description":"What to tell the sharer before they confirm.","default":"Anyone with the link sees this verdict and the product link. It never says who checked."}},"type":"object","required":["title","host","product_url","checked_on","checked_on_text","band","label","symbol","headline","result"],"title":"SharePreview","description":"Exactly what a share makes public."},"ShareRequest":{"properties":{"share_token":{"type":"string","maxLength":2000,"title":"Share Token","description":"The share_token from the analysis result."},"url":{"type":"string","maxLength":4000,"minLength":8,"title":"Url","description":"The url that was checked, as it was sent."},"result":{"$ref":"#/components/schemas/SharedAnalysis","description":"The result, exactly as it was returned."}},"type":"object","required":["share_token","url","result"],"title":"ShareRequest","description":"A result to share, sent back with the check it came from."},"SharedAnalysis":{"properties":{"score":{"type":"integer","maximum":100.0,"minimum":-1.0,"title":"Score"},"explanation":{"type":"string","maxLength":4000,"title":"Explanation"},"assessment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Assessment"},"verdict":{"anyOf":[{"$ref":"#/components/schemas/Verdict-Input"},{"type":"null"}]}},"type":"object","required":["score","explanation"],"title":"SharedAnalysis","description":"The analysis result, as ``POST /v1/analyze`` returned it (only these fields are read; others are ignored)."},"SharedResult":{"properties":{"title":{"type":"string","title":"Title","description":"The product's title, as the page showed it (or the shop when it had none)."},"host":{"type":"string","title":"Host","description":"The shop or marketplace."},"product_url":{"type":"string","title":"Product Url","description":"The product page (without tracking parameters), linked nofollow."},"checked_on":{"type":"string","format":"date","title":"Checked On","description":"The day of the check; the page may have changed since."},"checked_on_text":{"type":"string","title":"Checked On Text","description":"The same day, in words."},"band":{"type":"string","enum":["reliable","concerns","careful","warning"],"title":"Band"},"label":{"type":"string","title":"Label","description":"What Unfret would tell a shopper about this listing."},"symbol":{"type":"string","title":"Symbol"},"headline":{"type":"string","title":"Headline"},"result":{"additionalProperties":true,"type":"object","title":"Result","description":"verdict (band, label, symbol, headline, reasons, positives) and, with flags, assessment (flags with labels only, confidence, model_version). No score, no quotes from the page."},"notice":{"type":"string","title":"Notice","description":"What to tell the sharer before they confirm.","default":"Anyone with the link sees this verdict and the product link. It never says who checked."},"id":{"type":"string","title":"Id"},"link":{"type":"string","title":"Link","description":"The share's page on this site, /r/<id>."},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"When it is deleted."}},"type":"object","required":["title","host","product_url","checked_on","checked_on_text","band","label","symbol","headline","result","id","link","expires_at"],"title":"SharedResult","description":"A shared result."},"StatsMonth":{"properties":{"month":{"type":"string","title":"Month"},"passes":{"type":"integer","title":"Passes","description":"Passes that came through your link or code."},"first_checks":{"type":"integer","title":"First Checks","description":"Of those, passes that made their first check this month."},"purchases":{"type":"integer","title":"Purchases"},"money":{"additionalProperties":{"$ref":"#/components/schemas/MoneyMonth"},"type":"object","title":"Money","description":"Per currency (usd, eur)."}},"type":"object","required":["month","passes","first_checks","purchases","money"],"title":"StatsMonth","description":"One month of an affiliate's numbers."},"StatsResponse":{"properties":{"name":{"type":"string","title":"Name"},"active":{"type":"boolean","title":"Active"},"codes":{"items":{"type":"string"},"type":"array","title":"Codes"},"months":{"items":{"$ref":"#/components/schemas/StatsMonth"},"type":"array","title":"Months","description":"The last 13 months with any activity, newest first."},"balance":{"additionalProperties":{"$ref":"#/components/schemas/Balance"},"type":"object","title":"Balance","description":"Per currency (usd, eur): what is payable, held, due, carried."},"rules":{"$ref":"#/components/schemas/Rules"}},"type":"object","required":["name","active","codes","months","balance","rules"],"title":"StatsResponse","description":"An affiliate's own numbers: counts and amounts only, nothing about any buyer."},"Testimonial":{"properties":{"text":{"type":"string","maxLength":2000,"title":"Text","default":""},"name":{"type":"string","maxLength":100,"title":"Name","default":""},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"posted":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Posted"}},"type":"object","title":"Testimonial","description":"A testimonial a service company publishes on its own site: its own content, read as it is shown.\n\nThe name is only what the site prints next to it (\"Jan, Utrecht\"); used during the check only."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VatBreakdown":{"properties":{"country":{"type":"string","title":"Country"},"vat_rate_pct":{"type":"string","title":"Vat Rate Pct"},"net_usd_micros":{"type":"integer","title":"Net Usd Micros","description":"The pack's price, credited to the account."},"vat_usd_micros":{"type":"integer","title":"Vat Usd Micros"},"total_usd_micros":{"type":"integer","title":"Total Usd Micros","description":"What is charged: net plus VAT."},"total_usd":{"type":"string","title":"Total Usd"}},"type":"object","required":["country","vat_rate_pct","net_usd_micros","vat_usd_micros","total_usd_micros","total_usd"],"title":"VatBreakdown","description":"What the buyer pays, in dollars, and why."},"Verdict-Input":{"properties":{"band":{"type":"string","enum":["reliable","concerns","careful","junk_or_scam"],"title":"Band"},"label":{"type":"string","title":"Label","description":"The band in words."},"headline":{"type":"string","title":"Headline","description":"One plain sentence explaining the verdict."},"reasons":{"items":{"$ref":"#/components/schemas/Reason"},"type":"array","maxItems":3,"title":"Reasons"},"positives":{"items":{"$ref":"#/components/schemas/Positive"},"type":"array","maxItems":3,"title":"Positives"},"language":{"type":"string","title":"Language","description":"Always en (kept for clients that read it).","default":"en"},"checklist":{"items":{"$ref":"#/components/schemas/CheckItem"},"type":"array","title":"Checklist","description":"What was checked, area by area (the result card's checklist)."},"checks_run":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Checks Run","description":"How many separate checks ran on this page and had something to check."},"next_step":{"anyOf":[{"$ref":"#/components/schemas/NextStep"},{"type":"null"}],"description":"One suggested next step."},"same_product":{"anyOf":[{"$ref":"#/components/schemas/SameProduct"},{"type":"null"}],"description":"A likely same product on another shop, shown first (with both photos)."},"deep_check":{"anyOf":[{"$ref":"#/components/schemas/DeepCheck"},{"type":"null"}],"description":"Quick results only: whether a deep check of this page is worth it and what it would add."}},"type":"object","required":["band","label","headline"],"title":"Verdict","description":"The shopper-facing result of an analysis."},"VerifyRequest":{"properties":{"address":{"type":"string","maxLength":64,"title":"Address","description":"The wallet's public key (base58)."},"signed_message":{"type":"string","maxLength":4096,"title":"Signed Message","description":"The exact bytes the wallet signed (base64)."},"signature":{"type":"string","maxLength":128,"title":"Signature","description":"The ed25519 signature (base64)."},"pair_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Pair Id","description":"Attach the session to this phone pairing (sign-in on a phone)."}},"type":"object","required":["address","signed_message","signature"],"title":"VerifyRequest","description":"A signed sign-in message."},"unfret__shopper__Verdict":{"properties":{"band":{"type":"string","enum":["reliable","concerns","careful","junk_or_scam"],"title":"Band"},"label":{"type":"string","title":"Label","description":"The band in words."},"headline":{"type":"string","title":"Headline","description":"One plain sentence explaining the verdict."},"reasons":{"items":{"$ref":"#/components/schemas/Reason"},"type":"array","maxItems":3,"title":"Reasons"},"positives":{"items":{"$ref":"#/components/schemas/Positive"},"type":"array","maxItems":3,"title":"Positives"},"language":{"type":"string","title":"Language","description":"Always en (kept for clients that read it).","default":"en"},"checklist":{"items":{"$ref":"#/components/schemas/CheckItem"},"type":"array","title":"Checklist","description":"What was checked, area by area (the result card's checklist)."},"checks_run":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Checks Run","description":"How many separate checks ran on this page and had something to check."},"next_step":{"anyOf":[{"$ref":"#/components/schemas/NextStep"},{"type":"null"}],"description":"One suggested next step."},"same_product":{"anyOf":[{"$ref":"#/components/schemas/SameProduct"},{"type":"null"}],"description":"A likely same product on another shop, shown first (with both photos)."},"deep_check":{"anyOf":[{"$ref":"#/components/schemas/DeepCheck"},{"type":"null"}],"description":"Quick results only: whether a deep check of this page is worth it and what it would add."}},"type":"object","required":["band","label","headline"],"title":"Verdict","description":"The shopper-facing result of an analysis."},"unfret__x402__verdict__Verdict":{"properties":{"action":{"type":"string","enum":["allow","warn","block"],"title":"Action","description":"\"warn\" means: ask your human before buying."},"assessed":{"type":"boolean","title":"Assessed","description":"False when the page couldn't be assessed (not a product page): risk_score is null.","default":true},"risk_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Risk Score","description":"0 = no concerns, 1 = clear risk; null if not assessed."},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"flags":{"items":{"$ref":"#/components/schemas/Flag"},"type":"array","title":"Flags"},"policy_applied":{"type":"string","enum":["strict","balanced","lenient"],"title":"Policy Applied"},"tier":{"type":"string","enum":["quick","deep"],"title":"Tier"},"cached":{"type":"boolean","title":"Cached","default":false},"source":{"type":"string","enum":["analysis","fingerprint"],"title":"Source","description":"\"fingerprint\": the answer of a full analysis of this listing in the last day, served again because the shop hasn't changed since.","default":"analysis"},"checked_at":{"type":"string","format":"date-time","title":"Checked At"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version","description":"The scorer model that set risk_score, if any."},"band":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Band","description":"reliable, concerns, careful or junk_or_scam: the same verdict a shopper sees, in words \"Looks fine\", \"Worth a look\", \"Think twice\" or \"Serious concerns\"."},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"One plain sentence for the human you're buying for."},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type","description":"aggregate_listing (marketplace), storefront, article or non_product; while the expansion classes are on, also p2p_listing (a private seller's ad), service_listing or service_site (service providers)."},"deep_check":{"anyOf":[{"$ref":"#/components/schemas/DeepCheck"},{"type":"null"}],"description":"Quick answers only: whether a deep check of this page is worth its price (suggested), what it would add here (adds) and why (reason). Not suggested at Serious concerns, on a big marketplace's own listing that looks fine, or when a deep check would add nothing for this page."}},"type":"object","required":["action","risk_score","confidence","flags","policy_applied","tier","checked_at"],"title":"Verdict","description":"The response of ``POST /v1/check``."}}},"x-agentcash-guidance":{"llmsTxtUrl":"https://unfret.net/llms.txt"},"x-agentcash-provenance":{"ownershipProofs":["4gkUCrePVjz9U95366BQn2ZHrrqbyiuWT5Zc2Jxk86EmQ1FsmaUyCtZxmpav9A6mVWiRFp1dyAN4t9tBBHhN3jeY"]},"x-discovery":{"ownershipProofs":["4gkUCrePVjz9U95366BQn2ZHrrqbyiuWT5Zc2Jxk86EmQ1FsmaUyCtZxmpav9A6mVWiRFp1dyAN4t9tBBHhN3jeY"]}}