{"openapi":"3.1.0","info":{"title":"Livecheck: Live Listing Status","version":"1.0.0","description":"Live status of a specific product page, marketplace listing, or job posting, read from the page at call time. Returns live, closed, or unknown plus title and evidence signals. Also one-shot page condition checks, 30-day URL watchers, watcher renew, and signed confirmation of form submissions and orders. On POST /v1/verify, /v1/verify/job, and /v1/verify/listing: The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. Builders: sign in with GitHub for 200 free checks, no wallet needed. https://livecheck.fly.dev/keys","contact":{"email":"moyecj@gmail.com"},"x-guidance":"Is this job posting still open? POST /v1/verify/job with {\"url\": \"<one job posting URL>\"} for $0.01. Is this product listing still available or sold out? POST /v1/verify/listing with {\"url\": \"<one eBay, Shopify, or product page URL>\"} for $0.01. Both return {status: live|closed|unknown, title, signals[], confidence}, read from the page at call time. Use before applying, recommending, buying, or scraping. Not a search engine: bring the URL. /v1/verify ($0.01) accepts any of these URLs. POST /v1/check ($0.02) for one-shot keyword / price-threshold / text-change checks. POST /v1/watch ($2.50) for 30-day watchers; HTTPS callback optional (pull GET /v1/watch/{id}/events). POST /v1/watch/renew ($2.50) extends a watcher. POST /v1/confirm ($0.10) and /v1/confirm/order ($0.25) after a form submission or checkout. On 503, wait for Retry-After and retry. For a list of URLs, send up to 8 checks at a time. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment.","x-tags":["listing-status","product-availability","job-postings","ecommerce","web-monitoring"],"x-starter-key":{"url":"https://livecheck.fly.dev/keys","description":"Builders: sign in with GitHub for 200 free checks, no wallet needed. Send Authorization: Bearer lc_live_… on POST /v1/verify, /v1/verify/job, or /v1/verify/listing. 200 free checks over 30 days, no wallet needed."}},"servers":[{"url":"https://livecheck.fly.dev"}],"paths":{"/v1/verify":{"post":{"operationId":"verifyListing","summary":"Is this listing, product, or job posting still live? ($0.01)","description":"POST {\"url\"} for one specific product page, marketplace listing (eBay, Shopify, Etsy, Poshmark, Mercari), or job posting (Greenhouse, Lever, Workday, Ashby, company careers pages). Livecheck fetches the page at call time and returns status live, closed, or unknown, with title, evidence signals (e.g. in stock, sold out, ended, apply form present, 404), HTTP status, canonical URL, and confidence. Use it before recommending, buying, applying, or scraping, and to clean stale URLs out of search results or datasets. Search engines and job boards are snapshots; this reads the page now. Not a search engine: bring the URL. Reads HTML (no JavaScript). Ashby, Workday, Lever, and Greenhouse job URLs may also use that vendor's public job-board API (no API key): a Greenhouse or Workday missing posting is closed, a listed posting can confirm live, and API errors fall back to HTML. A Lever or Ashby posting missing from the public feed is not closed on that alone. Bot challenges stay unknown. Availability only, not legitimacy or fraud risk. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","x-guidance":"POST {\"url\"} for one specific product page, marketplace listing (eBay, Shopify, Etsy, Poshmark, Mercari), or job posting (Greenhouse, Lever, Workday, Ashby, company careers pages). Livecheck fetches the page at call time and returns status live, closed, or unknown, with title, evidence signals (e.g. in stock, sold out, ended, apply form present, 404), HTTP status, canonical URL, and confidence. Use it before recommending, buying, applying, or scraping, and to clean stale URLs out of search results or datasets. Search engines and job boards are snapshots; this reads the page now. Not a search engine: bring the URL. Reads HTML (no JavaScript). Ashby, Workday, Lever, and Greenhouse job URLs may also use that vendor's public job-board API (no API key): a Greenhouse or Workday missing posting is closed, a listed posting can confirm live, and API errors fall back to HTML. A Lever or Ashby posting missing from the public feed is not closed on that alone. Bot challenges stay unknown. Availability only, not legitimacy or fraud risk. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","tags":["listing-status","product-availability","job-postings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC"}},{"mpp":{"method":"tempo/charge","chainId":4217,"asset":"USDC.e"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL of the specific job, product, or eBay item page to check. Not a search-results URL."}},"required":["url"]}}}},"responses":{"200":{"description":"Primary-source live, closed, or unknown verdict. Paid 200 with status live includes watch suggest for POST /v1/watch (detector status_change, $2.50); closed and unknown have no watch field. Unpaid 402 has no watch field.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"canonical_url":{"type":"string"},"status":{"type":"string","enum":["live","closed","unknown"]},"label":{"type":"string","enum":["backorder","in_stores_only"],"description":"Optional label adds detail to a live result. backorder: can be ordered now, ships later. in_stores_only: not purchasable online, so agents completing an online purchase should treat it as unavailable."},"http_status":{"type":"number"},"checked_at":{"type":"string"},"title":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"price_usd":{"type":"number"},"message":{"type":"string","description":"Set when the URL is a job board or careers index instead of one posting. Ask for a single posting URL. Omitted on live and closed answers."},"route":{"type":"string","description":"API path that produced this response, after /v1/ and without a leading slash.","enum":["verify","verify/job","verify/listing"]},"watch":{"type":"object","description":"Present on paid 200 Confirm responses, and on paid 200 Verify responses only when status is live (omitted on closed and unknown). Cross-sell hint to POST /v1/watch ($2.50, 30-day standard watcher). Default detector is status_change. Not included on unpaid 402.","properties":{"suggest":{"type":"string","enum":["/v1/watch"]},"detector":{"type":"string","enum":["status_change"]},"price_usd":{"type":"number"}},"required":["suggest","detector","price_usd"]},"paid_with":{"type":"string","enum":["free_credit"],"description":"Set to free_credit when a starter key paid for the call. price_usd is then 0."},"credits_remaining":{"type":"number","description":"Starter-key free checks left after this call."},"credit_used":{"type":"boolean","description":"Whether this call used one starter-key credit."},"age":{"type":"object","description":"Job postings only. How long the posting has been up, from the hiring platform's first-posted date (or the page's JSON-LD datePosted). Context only: never changes status or confidence. Never taken from a last-updated date; unknown when there is no posted date.","properties":{"posted_at":{"type":["string","null"]},"age_days":{"type":["number","null"]},"age_days_min":{"type":"number","description":"Lower bound when only \"30+ days\" is known (Workday)."},"age_source":{"type":"string","enum":["greenhouse.first_published","greenhouse.published_at","ashby.publishedAt","lever.createdAt","workday.startDate","workday.postedOn_text","jsonld.datePosted","none"]},"age_precision":{"type":"string","enum":["exact","day","at_least","unknown"]},"age_bucket":{"type":"string","enum":["0-7","8-30","31-60","61-90","90+","30+","unknown"]},"stale_age":{"type":["boolean","null"],"description":"age_days >= stale_after_days (default 60: \"60 and up\"); null when unknown."},"stale_after_days":{"type":"number"},"last_updated_at":{"type":"string","description":"ATS last-updated date. Not the posted date."},"note":{"type":"string"}},"required":["posted_at","age_days","age_source","age_precision","age_bucket","stale_age","stale_after_days"]}},"required":["url","canonical_url","status","http_status","checked_at","signals","confidence","price_usd","route"]},"example":{"url":"https://boards.greenhouse.io/example/jobs/1842","canonical_url":"https://boards.greenhouse.io/example/jobs/1842","status":"live","http_status":200,"checked_at":"2026-08-30T21:00:00Z","title":"Staff Backend Engineer — Northwind Labs","signals":["apply form present","no closure banner"],"confidence":0.92,"price_usd":0.01,"route":"verify","watch":{"suggest":"/v1/watch","detector":"status_change","price_usd":2.5}}}}},"402":{"description":"Payment Required. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted."}}}},"/v1/verify/job":{"post":{"operationId":"verifyJob","summary":"Is this job posting still open? Check one specific job URL before applying ($0.01)","description":"POST {\"url\"} for one specific job posting page. Livecheck fetches the posting at call time and returns open or closed status as live, closed, or unknown, with the job title and evidence signals. Works on company careers pages and applicant tracking systems such as Greenhouse, Lever, Workday, Ashby, SmartRecruiters, and iCIMS. Detects closed postings from 404 and 410 responses, redirects back to the job board, empty ATS listings, and closure language such as \"position filled\", \"no longer accepting applications\", and \"this job has expired\". For Ashby, Workday, Lever, and Greenhouse posting URLs, may also consult that vendor's public job-board API (no API key). If Greenhouse or Workday reports the posting missing, the verdict is closed (ats_api_missing). A Lever or Ashby posting missing from the public feed is not closed on that alone (ats_not_in_public_feed): an apply form stays live, and closed still requires a 404, a redirect to the board, or a closure banner. If the API lists it and the page is live or a JavaScript-only shell, the verdict is live (ats_api_listed). If the page looks closed but the API still lists it, the verdict is unknown. Livecheck does not bypass Cloudflare or reCAPTCHA: a bot challenge page alone is unknown (challenge_page), and when the link carries a job id the vendor's public API answers instead. A job link that redirects to a search, list or board page, or loses its job id, is closed or unknown, never live. LinkedIn isn't supported (its robots.txt blocks automated checks). Use the company's own job link. API timeouts and HTTP 5xx fall back to the HTML read and are never treated as closed. Not a job search: bring the posting URL. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","x-guidance":"POST {\"url\"} for one specific job posting page. Livecheck fetches the posting at call time and returns open or closed status as live, closed, or unknown, with the job title and evidence signals. Works on company careers pages and applicant tracking systems such as Greenhouse, Lever, Workday, Ashby, SmartRecruiters, and iCIMS. Detects closed postings from 404 and 410 responses, redirects back to the job board, empty ATS listings, and closure language such as \"position filled\", \"no longer accepting applications\", and \"this job has expired\". For Ashby, Workday, Lever, and Greenhouse posting URLs, may also consult that vendor's public job-board API (no API key). If Greenhouse or Workday reports the posting missing, the verdict is closed (ats_api_missing). A Lever or Ashby posting missing from the public feed is not closed on that alone (ats_not_in_public_feed): an apply form stays live, and closed still requires a 404, a redirect to the board, or a closure banner. If the API lists it and the page is live or a JavaScript-only shell, the verdict is live (ats_api_listed). If the page looks closed but the API still lists it, the verdict is unknown. Livecheck does not bypass Cloudflare or reCAPTCHA: a bot challenge page alone is unknown (challenge_page), and when the link carries a job id the vendor's public API answers instead. A job link that redirects to a search, list or board page, or loses its job id, is closed or unknown, never live. LinkedIn isn't supported (its robots.txt blocks automated checks). Use the company's own job link. API timeouts and HTTP 5xx fall back to the HTML read and are never treated as closed. Not a job search: bring the posting URL. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","tags":["job-postings","job-status","listing-status"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC"}},{"mpp":{"method":"tempo/charge","chainId":4217,"asset":"USDC.e"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL of the specific job, product, or eBay item page to check. Not a search-results URL."}},"required":["url"]}}}},"responses":{"200":{"description":"Primary-source live, closed, or unknown verdict. Paid 200 with status live includes watch suggest for POST /v1/watch (detector status_change, $2.50); closed and unknown have no watch field. Unpaid 402 has no watch field.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"canonical_url":{"type":"string"},"status":{"type":"string","enum":["live","closed","unknown"]},"label":{"type":"string","enum":["backorder","in_stores_only"],"description":"Optional label adds detail to a live result. backorder: can be ordered now, ships later. in_stores_only: not purchasable online, so agents completing an online purchase should treat it as unavailable."},"http_status":{"type":"number"},"checked_at":{"type":"string"},"title":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"price_usd":{"type":"number"},"message":{"type":"string","description":"Set when the URL is a job board or careers index instead of one posting. Ask for a single posting URL. Omitted on live and closed answers."},"route":{"type":"string","description":"API path that produced this response, after /v1/ and without a leading slash.","enum":["verify","verify/job","verify/listing"]},"watch":{"type":"object","description":"Present on paid 200 Confirm responses, and on paid 200 Verify responses only when status is live (omitted on closed and unknown). Cross-sell hint to POST /v1/watch ($2.50, 30-day standard watcher). Default detector is status_change. Not included on unpaid 402.","properties":{"suggest":{"type":"string","enum":["/v1/watch"]},"detector":{"type":"string","enum":["status_change"]},"price_usd":{"type":"number"}},"required":["suggest","detector","price_usd"]},"paid_with":{"type":"string","enum":["free_credit"],"description":"Set to free_credit when a starter key paid for the call. price_usd is then 0."},"credits_remaining":{"type":"number","description":"Starter-key free checks left after this call."},"credit_used":{"type":"boolean","description":"Whether this call used one starter-key credit."},"age":{"type":"object","description":"Job postings only. How long the posting has been up, from the hiring platform's first-posted date (or the page's JSON-LD datePosted). Context only: never changes status or confidence. Never taken from a last-updated date; unknown when there is no posted date.","properties":{"posted_at":{"type":["string","null"]},"age_days":{"type":["number","null"]},"age_days_min":{"type":"number","description":"Lower bound when only \"30+ days\" is known (Workday)."},"age_source":{"type":"string","enum":["greenhouse.first_published","greenhouse.published_at","ashby.publishedAt","lever.createdAt","workday.startDate","workday.postedOn_text","jsonld.datePosted","none"]},"age_precision":{"type":"string","enum":["exact","day","at_least","unknown"]},"age_bucket":{"type":"string","enum":["0-7","8-30","31-60","61-90","90+","30+","unknown"]},"stale_age":{"type":["boolean","null"],"description":"age_days >= stale_after_days (default 60: \"60 and up\"); null when unknown."},"stale_after_days":{"type":"number"},"last_updated_at":{"type":"string","description":"ATS last-updated date. Not the posted date."},"note":{"type":"string"}},"required":["posted_at","age_days","age_source","age_precision","age_bucket","stale_age","stale_after_days"]}},"required":["url","canonical_url","status","http_status","checked_at","signals","confidence","price_usd","route"]},"example":{"url":"https://boards.greenhouse.io/example/jobs/1842","canonical_url":"https://boards.greenhouse.io/example/jobs/1842","status":"live","http_status":200,"checked_at":"2026-08-30T21:00:00Z","title":"Staff Backend Engineer — Northwind Labs","signals":["apply form present","no closure banner"],"confidence":0.92,"price_usd":0.01,"route":"verify/job","watch":{"suggest":"/v1/watch","detector":"status_change","price_usd":2.5}}}}},"402":{"description":"Payment Required. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted."}}}},"/v1/verify/listing":{"post":{"operationId":"verifyProductListing","summary":"Is this product listing still available or sold out? Check one eBay, Shopify, or product page URL ($0.01)","description":"POST {\"url\"} for one specific product page or marketplace listing. Livecheck fetches the page at call time and returns live, closed, or unknown with the title and evidence signals such as in-stock, sold-out, and eBay listing ended. Works on eBay item pages, Shopify product pages, and standard HTML product pages. Use it before recommending a product, before adding to cart or buying, and to remove sold-out or deleted items from shopping search results, price comparisons, and scraped product lists. Search engines and shopping indexes are snapshots; this reads the page now. Not a product search: bring the item URL. Reads HTML only; unknown means the page could not be read reliably. Availability only, not legitimacy or fraud risk. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","x-guidance":"POST {\"url\"} for one specific product page or marketplace listing. Livecheck fetches the page at call time and returns live, closed, or unknown with the title and evidence signals such as in-stock, sold-out, and eBay listing ended. Works on eBay item pages, Shopify product pages, and standard HTML product pages. Use it before recommending a product, before adding to cart or buying, and to remove sold-out or deleted items from shopping search results, price comparisons, and scraped product lists. Search engines and shopping indexes are snapshots; this reads the page now. Not a product search: bring the item URL. Reads HTML only; unknown means the page could not be read reliably. Availability only, not legitimacy or fraud risk. Fixed $0.01. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted. On 503 over_capacity or x402 processor_unavailable, wait for Retry-After and retry; you were not charged. An MPP 503 with error payment_unconfirmed means the payment could not be confirmed: a possible charge is logged for refund. Retry with the same credential, not a new payment. An x402 503 with error payment_status_unknown means the payment took longer than 5 seconds to settle: Payment status unknown. Don't retry for 60 seconds. If you were charged and got no answer, we'll refund it. Retry-After is 60. Do not treat 503 as closed or unknown. For a list of URLs, send up to 8 checks at a time.","tags":["product-availability","listing-status","ecommerce"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC"}},{"mpp":{"method":"tempo/charge","chainId":4217,"asset":"USDC.e"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL of the specific job, product, or eBay item page to check. Not a search-results URL."}},"required":["url"]}}}},"responses":{"200":{"description":"Primary-source live, closed, or unknown verdict. Paid 200 with status live includes watch suggest for POST /v1/watch (detector status_change, $2.50); closed and unknown have no watch field. Unpaid 402 has no watch field.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"canonical_url":{"type":"string"},"status":{"type":"string","enum":["live","closed","unknown"]},"label":{"type":"string","enum":["backorder","in_stores_only"],"description":"Optional label adds detail to a live result. backorder: can be ordered now, ships later. in_stores_only: not purchasable online, so agents completing an online purchase should treat it as unavailable."},"http_status":{"type":"number"},"checked_at":{"type":"string"},"title":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"price_usd":{"type":"number"},"message":{"type":"string","description":"Set when the URL is a job board or careers index instead of one posting. Ask for a single posting URL. Omitted on live and closed answers."},"route":{"type":"string","description":"API path that produced this response, after /v1/ and without a leading slash.","enum":["verify","verify/job","verify/listing"]},"watch":{"type":"object","description":"Present on paid 200 Confirm responses, and on paid 200 Verify responses only when status is live (omitted on closed and unknown). Cross-sell hint to POST /v1/watch ($2.50, 30-day standard watcher). Default detector is status_change. Not included on unpaid 402.","properties":{"suggest":{"type":"string","enum":["/v1/watch"]},"detector":{"type":"string","enum":["status_change"]},"price_usd":{"type":"number"}},"required":["suggest","detector","price_usd"]},"paid_with":{"type":"string","enum":["free_credit"],"description":"Set to free_credit when a starter key paid for the call. price_usd is then 0."},"credits_remaining":{"type":"number","description":"Starter-key free checks left after this call."},"credit_used":{"type":"boolean","description":"Whether this call used one starter-key credit."},"age":{"type":"object","description":"Job postings only. How long the posting has been up, from the hiring platform's first-posted date (or the page's JSON-LD datePosted). Context only: never changes status or confidence. Never taken from a last-updated date; unknown when there is no posted date.","properties":{"posted_at":{"type":["string","null"]},"age_days":{"type":["number","null"]},"age_days_min":{"type":"number","description":"Lower bound when only \"30+ days\" is known (Workday)."},"age_source":{"type":"string","enum":["greenhouse.first_published","greenhouse.published_at","ashby.publishedAt","lever.createdAt","workday.startDate","workday.postedOn_text","jsonld.datePosted","none"]},"age_precision":{"type":"string","enum":["exact","day","at_least","unknown"]},"age_bucket":{"type":"string","enum":["0-7","8-30","31-60","61-90","90+","30+","unknown"]},"stale_age":{"type":["boolean","null"],"description":"age_days >= stale_after_days (default 60: \"60 and up\"); null when unknown."},"stale_after_days":{"type":"number"},"last_updated_at":{"type":"string","description":"ATS last-updated date. Not the posted date."},"note":{"type":"string"}},"required":["posted_at","age_days","age_source","age_precision","age_bucket","stale_age","stale_after_days"]}},"required":["url","canonical_url","status","http_status","checked_at","signals","confidence","price_usd","route"]},"example":{"url":"https://boards.greenhouse.io/example/jobs/1842","canonical_url":"https://boards.greenhouse.io/example/jobs/1842","status":"live","http_status":200,"checked_at":"2026-08-30T21:00:00Z","title":"Staff Backend Engineer — Northwind Labs","signals":["apply form present","no closure banner"],"confidence":0.92,"price_usd":0.01,"route":"verify/listing","watch":{"suggest":"/v1/watch","detector":"status_change","price_usd":2.5}}}}},"402":{"description":"Payment Required. The unpaid 402 offers both x402 (Base USDC) and MPP (Tempo USDC.e). Each charges exactly $0.01. MPP method is tempo/charge: USDC.e on Tempo (chain 4217). Stripe pays Tempo gas. With MPP (Tempo): Paid answers, including the checked link, are kept for 24 hours so retries are safe, then deleted."}}}},"/v1/check":{"post":{"operationId":"sentinelCheck","summary":"One-shot URL condition check ($0.02)","description":"POST {target, condition, baseline_hash?} for a one-shot check. No watcher is created. target.type=url, render=never (HTML only). Detectors: status_change — reuse Verify fetch/classify; fired when status or HTTP class differs from baseline_hash. keyword — params.any/all/none string arrays, optional selector, case_sensitive default false; fired when the presence set matches. text_diff — params.selector recommended (without it confidence is capped at 0.6), params.ignore regex array, params.min_change_ratio default 0.02; hashes after the ignore-by-default list (timestamps, viewers/sold, session ids, CSRF, ad slots, cookie banners). numeric_threshold — params.selector or params.jsonpath, params.op lt/lte/gt/gte/eq/change_pct, params.value, optional params.currency; parses $1,299.00 / 1 299,00 EUR / 149. Returns observation (status/signals/http_status/hash/summary), fired when comparable, confidence, price_usd 0.02, id (chk_ + ULID), and a Confirm-style receipt. 400 invalid_target / invalid_condition. 422 baseline_unreachable when the target cannot be fetched, baseline_hash is unusable, or keyword/text_diff/numeric gets HTTP 5xx (including 530), a timeout, a DNS failure, or a challenge page (no observation). status_change: 404 and 410 are closed; 5xx and timeouts are unreachable, not closed. Unpaid → 402 with one $0.02 accept (20000 atomic).","x-guidance":"POST {target, condition, baseline_hash?} for a one-shot check. No watcher is created. target.type=url, render=never (HTML only). Detectors: status_change — reuse Verify fetch/classify; fired when status or HTTP class differs from baseline_hash. keyword — params.any/all/none string arrays, optional selector, case_sensitive default false; fired when the presence set matches. text_diff — params.selector recommended (without it confidence is capped at 0.6), params.ignore regex array, params.min_change_ratio default 0.02; hashes after the ignore-by-default list (timestamps, viewers/sold, session ids, CSRF, ad slots, cookie banners). numeric_threshold — params.selector or params.jsonpath, params.op lt/lte/gt/gte/eq/change_pct, params.value, optional params.currency; parses $1,299.00 / 1 299,00 EUR / 149. Returns observation (status/signals/http_status/hash/summary), fired when comparable, confidence, price_usd 0.02, id (chk_ + ULID), and a Confirm-style receipt. 400 invalid_target / invalid_condition. 422 baseline_unreachable when the target cannot be fetched, baseline_hash is unusable, or keyword/text_diff/numeric gets HTTP 5xx (including 530), a timeout, a DNS failure, or a challenge page (no observation). status_change: 404 and 410 are closed; 5xx and timeouts are unreachable, not closed. Unpaid → 402 with one $0.02 accept (20000 atomic).","tags":["Sentinel","check"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","description":"URL target. type must be url. render must be never. selector optional.","properties":{"type":{"type":"string","enum":["url"]},"url":{"type":"string","format":"uri"},"render":{"type":"string","enum":["never"]},"selector":{"type":["string","null"]}},"required":["type","url"]},"condition":{"type":"object","description":"detector status_change, keyword, text_diff, or numeric_threshold. text_diff: selector?, ignore[], min_change_ratio default 0.02. numeric_threshold: selector or jsonpath, op, value, currency?.","properties":{"detector":{"type":"string","enum":["status_change","keyword","text_diff","numeric_threshold"]},"params":{"type":"object"}},"required":["detector"]},"baseline_hash":{"type":["string","null"],"description":"Prior observation.hash. Required for status_change fired. Omit on first check."}},"required":["target","condition"]}}}},"responses":{"200":{"description":"Current observation, optional fired, chk_ id, and receipt","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Stable check id (chk_ + ULID)."},"target":{"type":"object","properties":{"type":{"type":"string","enum":["url"]},"url":{"type":"string"},"render":{"type":"string","enum":["never"]},"selector":{"type":["string","null"]}},"required":["type","url","render"]},"condition":{"type":"object","properties":{"detector":{"type":"string","enum":["status_change","keyword","text_diff","numeric_threshold"]},"params":{"type":"object"}},"required":["detector"]},"observation":{"type":"object","properties":{"status":{"type":"string","enum":["live","closed","unknown"]},"signals":{"type":"array","items":{"type":"string"}},"http_status":{"type":"number"},"http_class":{"type":"string"},"hash":{"type":"string"},"summary":{"type":"string"},"checked_at":{"type":"string"},"canonical_url":{"type":"string"},"title":{"type":"string"}},"required":["status","signals","http_status","http_class","hash","summary"]},"fired":{"type":["boolean","null"]},"confidence":{"type":"number"},"price_usd":{"type":"number"},"receipt":{"type":"object","properties":{"hash":{"type":"string"},"signature":{"type":"string"},"signer":{"type":"string"},"verify_url":{"type":"string"}},"required":["hash","verify_url"]}},"required":["id","target","condition","observation","fired","confidence","price_usd","receipt"]}}}},"400":{"description":"invalid_target or invalid_condition"},"402":{"description":"Payment required. Fixed $0.02 USDC (20000 atomic)."},"422":{"description":"baseline_unreachable — target fetch failed or baseline_hash unusable"}}}},"/v1/watch":{"post":{"operationId":"sentinelWatch","summary":"Create a 30-day URL condition watcher ($2.50)","description":"POST {target, condition, callback?, interval_s?, label?, context?, on_change?, chain_budget_usd?} to create a standard watcher. Omit callback to pull events with the owner token on GET /v1/watch/{id}/events (no public HTTPS endpoint required). When callback is present it must be {url, secret, deliver?}. target.type=url, render=never (HTML only). render=always → 400 render_not_available (use /v1/watch/fast when that route ships). Detectors: status_change, keyword, text_diff, numeric_threshold — same internals as POST /v1/check. Standard tier emits change only after 2-of-3 confirmation: two consecutive candidate checks, or one candidate plus a ~20s confirmation re-fetch. callback.deliver on_change or every_check is accepted (standard still skips baseline spam). When callback.url is set, HMAC POSTs to that URL with X-Sentinel-Signature t=<unix>,v1=<hex> (HMAC-SHA256 of the raw JSON body with callback.secret). Pull-only watchers store events as already delivered and do not POST. Failed deliveries retry 1m, 5m, 30m, 2h (5 attempts); events are never dropped. on_change.run is none, verify, or confirm. confirm default intent is lead_submit ($0.10, same as POST /v1/confirm); set on_change.intent to listing_published ($0.10) or order_placed ($0.25, same as POST /v1/confirm/order). Optional on_change.url overrides the Confirm URL (default target.url); optional on_change.claim is forwarded to Confirm. Chain Confirm is internal (no public x402 / no new route price) and writes a cfm_ receipt to receipts.sqlite. chain_budget_usd is a spend cap only — the $2.50 watch price does not include chain funds. Fund via POST /v1/watch/{id}/chain/topup ($0.50, owner token + payment). interval_s min 300, default 900, max 2880 checks per 30-day term. Baseline is captured synchronously (≤10s); fetch failure still returns 201 with baseline.captured=false (never 422). owner_token (owt_…) is returned once; send it as X-Livecheck-Owner-Token on GET/DELETE /v1/watch/{id}, GET /v1/watch/{id}/events, POST /v1/watch/renew, and POST /v1/watch/{id}/chain/topup. DELETE stops early with no refund. Duplicate active watcher for the same paying wallet + target.url + condition → 409 duplicate_watch. Soft cap 200 active standard watchers per wallet → 429 rate_limited. Unpaid → 402 with one $2.50 accept (2500000 atomic).","x-guidance":"POST {target, condition, callback?, interval_s?, label?, context?, on_change?, chain_budget_usd?} to create a standard watcher. Omit callback to pull events with the owner token on GET /v1/watch/{id}/events (no public HTTPS endpoint required). When callback is present it must be {url, secret, deliver?}. target.type=url, render=never (HTML only). render=always → 400 render_not_available (use /v1/watch/fast when that route ships). Detectors: status_change, keyword, text_diff, numeric_threshold — same internals as POST /v1/check. Standard tier emits change only after 2-of-3 confirmation: two consecutive candidate checks, or one candidate plus a ~20s confirmation re-fetch. callback.deliver on_change or every_check is accepted (standard still skips baseline spam). When callback.url is set, HMAC POSTs to that URL with X-Sentinel-Signature t=<unix>,v1=<hex> (HMAC-SHA256 of the raw JSON body with callback.secret). Pull-only watchers store events as already delivered and do not POST. Failed deliveries retry 1m, 5m, 30m, 2h (5 attempts); events are never dropped. on_change.run is none, verify, or confirm. confirm default intent is lead_submit ($0.10, same as POST /v1/confirm); set on_change.intent to listing_published ($0.10) or order_placed ($0.25, same as POST /v1/confirm/order). Optional on_change.url overrides the Confirm URL (default target.url); optional on_change.claim is forwarded to Confirm. Chain Confirm is internal (no public x402 / no new route price) and writes a cfm_ receipt to receipts.sqlite. chain_budget_usd is a spend cap only — the $2.50 watch price does not include chain funds. Fund via POST /v1/watch/{id}/chain/topup ($0.50, owner token + payment). interval_s min 300, default 900, max 2880 checks per 30-day term. Baseline is captured synchronously (≤10s); fetch failure still returns 201 with baseline.captured=false (never 422). owner_token (owt_…) is returned once; send it as X-Livecheck-Owner-Token on GET/DELETE /v1/watch/{id}, GET /v1/watch/{id}/events, POST /v1/watch/renew, and POST /v1/watch/{id}/chain/topup. DELETE stops early with no refund. Duplicate active watcher for the same paying wallet + target.url + condition → 409 duplicate_watch. Soft cap 200 active standard watchers per wallet → 429 rate_limited. Unpaid → 402 with one $2.50 accept (2500000 atomic).","tags":["Sentinel","watch"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.50"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","description":"URL target. type must be url. render must be never. render=always is 400 render_not_available.","properties":{"type":{"type":"string","enum":["url"]},"url":{"type":"string","format":"uri"},"render":{"type":"string","enum":["never"]},"selector":{"type":["string","null"]}},"required":["type","url"]},"condition":{"type":"object","description":"detector status_change, keyword, text_diff, or numeric_threshold. Same detectors as POST /v1/check.","properties":{"detector":{"type":"string","enum":["status_change","keyword","text_diff","numeric_threshold"]},"params":{"type":"object"}},"required":["detector"]},"callback":{"type":"object","description":"Optional. Omit it and pull GET /v1/watch/{id}/events with the owner token. When set: HTTPS url, secret, deliver=on_change or every_check. HMAC-SHA256 over the raw JSON body; header X-Sentinel-Signature: t=<unix>,v1=<hex>.","properties":{"url":{"type":"string","format":"uri"},"secret":{"type":"string"},"deliver":{"type":"string","enum":["on_change","every_check"]}},"required":["url","secret"]},"interval_s":{"type":"integer","minimum":300,"default":900,"description":"Seconds between observations. Min 300, default 900. Max 2880 checks/term."},"label":{"type":"string"},"context":{"type":"object"},"chain_budget_usd":{"type":"number","description":"Spend cap for chained Verify ($0.01) and Confirm ($0.10 / $0.25). Funding is POST /v1/watch/{id}/chain/topup ($0.50), not bundled into the $2.50 watch price."},"on_change":{"type":"object","description":"run=none (default), verify, or confirm. On emitted change, verify ($0.01) or Confirm (lead_submit/listing_published $0.10, order_placed $0.25) runs internally when chain balance covers the debit. Confirm default intent is lead_submit; optional url defaults to target.url. Writes cfm_ receipts to receipts.sqlite. No new public x402 price.","properties":{"run":{"type":"string","enum":["none","verify","confirm"]},"intent":{"type":"string","enum":["lead_submit","listing_published","order_placed"],"description":"Confirm only. Default lead_submit."},"url":{"type":"string","format":"uri","description":"Confirm only. Override URL; default target.url."},"claim":{"type":"object","description":"Confirm only. Optional claim forwarded to Confirm."}}}},"required":["target","condition"]}}}},"responses":{"201":{"description":"Watcher created. owner_token is returned once.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Stable watcher id (wtc_ + ULID)."},"tier":{"type":"string","enum":["standard"]},"status":{"type":"string","enum":["active","stopped","expired"]},"owner_token":{"type":"string","description":"Returned once on create. Send as X-Livecheck-Owner-Token."},"expires_at":{"type":"string"},"checks_remaining":{"type":"number"},"interval_s":{"type":"number"},"first_check_at":{"type":"string"},"next_check_at":{"type":"string"},"baseline":{"type":"object","properties":{"captured":{"type":"boolean"},"hash":{"type":"string"},"summary":{"type":"string"}},"required":["captured"]},"target":{"type":"object","properties":{"type":{"type":"string","enum":["url"]},"url":{"type":"string"},"render":{"type":"string","enum":["never"]},"selector":{"type":["string","null"]}},"required":["type","url","render"]},"condition":{"type":"object","properties":{"detector":{"type":"string","enum":["status_change","keyword","text_diff","numeric_threshold"]},"params":{"type":"object"}},"required":["detector"]},"price_usd":{"type":"number"},"run":{"type":"string","enum":["none","verify","confirm"]},"on_change":{"type":"object","properties":{"run":{"type":"string","enum":["none","verify","confirm"]},"intent":{"type":"string","enum":["lead_submit","listing_published","order_placed"]},"url":{"type":"string"}}},"chain_budget_usd":{"type":["number","null"]},"chain_balance_usd":{"type":"number"},"receipt":{"type":"object","properties":{"hash":{"type":"string"},"signature":{"type":"string"},"signer":{"type":"string"},"verify_url":{"type":"string"}},"required":["hash","verify_url"]}},"required":["id","tier","owner_token","expires_at","checks_remaining","interval_s","first_check_at","baseline","price_usd","receipt"]}}}},"400":{"description":"invalid_target, invalid_condition, invalid_callback, invalid_interval, or render_not_available"},"402":{"description":"Payment required. Fixed $2.50 USDC (2500000 atomic)."},"409":{"description":"duplicate_watch — same paying wallet + target.url + condition while active"},"429":{"description":"rate_limited — 200 active standard watchers per wallet"}}}},"/v1/watch/renew":{"post":{"operationId":"sentinelWatchRenew","summary":"Renew an active 30-day watcher ($2.50)","description":"POST {id} to extend an active standard watcher's prepaid window (Confirm continuity / Wave 4). Same $2.50 USDC (2500000 atomic) as POST /v1/watch — one accept, no dual price. id is the watcher id (wtc_ + ULID) in the JSON body so /.well-known/x402 can list a concrete URL (no {id} template). Requires X-Livecheck-Owner-Token in addition to payment (same as GET/DELETE /v1/watch/{id} and chain topup). Extends expires_at by 30 days from the later of now and the current expiry, and adds one term of checks_remaining (interval-based, max 2880/term). Same watcher id, target, condition, callback, and chain balance. Does not add detectors, lifecycle event types, or recapture baseline. Does not return owner_token. Stopped or expired → 409 not_renewable. Missing owner token after pay → 401. Wrong token → 403. Unknown id → 404. Unpaid → 402 with one $2.50 accept. Not Playwright / /v1/watch/fast. Not Confirm chain.","x-guidance":"POST {id} to extend an active standard watcher's prepaid window (Confirm continuity / Wave 4). Same $2.50 USDC (2500000 atomic) as POST /v1/watch — one accept, no dual price. id is the watcher id (wtc_ + ULID) in the JSON body so /.well-known/x402 can list a concrete URL (no {id} template). Requires X-Livecheck-Owner-Token in addition to payment (same as GET/DELETE /v1/watch/{id} and chain topup). Extends expires_at by 30 days from the later of now and the current expiry, and adds one term of checks_remaining (interval-based, max 2880/term). Same watcher id, target, condition, callback, and chain balance. Does not add detectors, lifecycle event types, or recapture baseline. Does not return owner_token. Stopped or expired → 409 not_renewable. Missing owner token after pay → 401. Wrong token → 403. Unknown id → 404. Unpaid → 402 with one $2.50 accept. Not Playwright / /v1/watch/fast. Not Confirm chain.","tags":["Sentinel","watch"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.50"},"protocols":[{"x402":{}}]},"parameters":[{"name":"X-Livecheck-Owner-Token","in":"header","required":true,"schema":{"type":"string"},"description":"owt_ token returned once on POST /v1/watch. Required in addition to payment."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Watcher id (wtc_ + ULID). In the body so the well-known URL stays concrete."}},"required":["id"]}}}},"responses":{"200":{"description":"Watcher prepaid window extended. owner_token is not returned again. Receipt id is wrn_.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Watcher id (wtc_ + ULID). Unchanged on renew."},"tier":{"type":"string","enum":["standard"]},"status":{"type":"string","enum":["active","stopped","expired"]},"expires_at":{"type":"string"},"checks_remaining":{"type":"number"},"interval_s":{"type":"number"},"first_check_at":{"type":"string"},"next_check_at":{"type":"string"},"baseline":{"type":"object","properties":{"captured":{"type":"boolean"},"hash":{"type":"string"},"summary":{"type":"string"}},"required":["captured"]},"target":{"type":"object","properties":{"type":{"type":"string","enum":["url"]},"url":{"type":"string"},"render":{"type":"string","enum":["never"]},"selector":{"type":["string","null"]}},"required":["type","url","render"]},"condition":{"type":"object","properties":{"detector":{"type":"string","enum":["status_change","keyword","text_diff","numeric_threshold"]},"params":{"type":"object"}},"required":["detector"]},"price_usd":{"type":"number"},"run":{"type":"string","enum":["none","verify"]},"on_change":{"type":"object","properties":{"run":{"type":"string","enum":["none","verify","confirm"]},"intent":{"type":"string","enum":["lead_submit","listing_published","order_placed"]},"url":{"type":"string"}}},"chain_budget_usd":{"type":["number","null"]},"chain_balance_usd":{"type":"number"},"receipt":{"type":"object","properties":{"hash":{"type":"string"},"signature":{"type":"string"},"signer":{"type":"string"},"verify_url":{"type":"string"}},"required":["hash","verify_url"]}},"required":["id","tier","expires_at","checks_remaining","interval_s","first_check_at","baseline","price_usd","receipt"]}}}},"400":{"description":"invalid_id — missing or malformed watcher id"},"401":{"description":"Missing owner token"},"402":{"description":"Payment required. Fixed $2.50 USDC (2500000 atomic). One accept."},"403":{"description":"Wrong owner token"},"404":{"description":"Unknown watcher"},"409":{"description":"not_renewable — watcher is stopped or expired"}}}},"/v1/watch/{id}":{"get":{"security":[],"operationId":"getSentinelWatch","summary":"Read a watcher (owner token required)","description":"Free. Send the owner_token from create as header X-Livecheck-Owner-Token. Does not return the token again. Does not refund or charge.","tags":["Sentinel","watch"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Watcher id (wtc_ + ULID)."},{"name":"X-Livecheck-Owner-Token","in":"header","required":true,"schema":{"type":"string"},"description":"owt_ token returned once on POST /v1/watch."}],"responses":{"200":{"description":"Watcher status, baseline, last observation"},"401":{"description":"Missing owner token"},"403":{"description":"Wrong owner token"},"404":{"description":"Unknown id"}}},"delete":{"security":[],"operationId":"deleteSentinelWatch","summary":"Stop a watcher early (no refund)","description":"Free. Requires X-Livecheck-Owner-Token. Stops the watcher immediately. No refund.","tags":["Sentinel","watch"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Watcher id (wtc_ + ULID)."},{"name":"X-Livecheck-Owner-Token","in":"header","required":true,"schema":{"type":"string"},"description":"owt_ token returned once on POST /v1/watch."}],"responses":{"200":{"description":"Stopped. { id, status: stopped, refund: false }"},"401":{"description":"Missing owner token"},"403":{"description":"Wrong owner token"},"404":{"description":"Unknown id"}}}},"/v1/watch/{id}/chain/topup":{"post":{"operationId":"sentinelWatchChainTopup","summary":"Add $0.50 chain balance to a watcher","description":"Paid $0.50 USDC (500000 atomic). One accept. Requires X-Livecheck-Owner-Token in addition to payment (owner token + payment). Credits $0.50 chain balance on the watcher in the path. Balance spends on on_change.run=verify ($0.01) or on_change.run=confirm ($0.10 lead_submit/listing_published, $0.25 order_placed). chain_budget_usd from create is a spend cap; this route is the only funding path (not bundled into POST /v1/watch $2.50). Unpaid → 402. Missing owner token after pay → 401. Wrong token → 403. Unknown id → 404.","x-guidance":"Paid $0.50 USDC (500000 atomic). One accept. Requires X-Livecheck-Owner-Token in addition to payment (owner token + payment). Credits $0.50 chain balance on the watcher in the path. Balance spends on on_change.run=verify ($0.01) or on_change.run=confirm ($0.10 lead_submit/listing_published, $0.25 order_placed). chain_budget_usd from create is a spend cap; this route is the only funding path (not bundled into POST /v1/watch $2.50). Unpaid → 402. Missing owner token after pay → 401. Wrong token → 403. Unknown id → 404.","tags":["Sentinel","watch","chain"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Watcher id (wtc_ + ULID)."},{"name":"X-Livecheck-Owner-Token","in":"header","required":true,"schema":{"type":"string"},"description":"owt_ token returned once on POST /v1/watch. Required in addition to payment."}],"responses":{"200":{"description":"Chain balance increased by $0.50.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Watcher id (wtc_ + ULID)."},"added_usd":{"type":"number"},"chain_balance_usd":{"type":"number"},"chain_budget_usd":{"type":["number","null"]},"price_usd":{"type":"number"},"run":{"type":"string","enum":["none","verify","confirm"]}},"required":["id","added_usd","chain_balance_usd","price_usd","run"]}}}},"401":{"description":"Missing owner token"},"402":{"description":"Payment required. Fixed $0.50 USDC (500000 atomic). One accept."},"403":{"description":"Wrong owner token"},"404":{"description":"Unknown watcher"}}}},"/v1/watch/{id}/events":{"get":{"security":[],"operationId":"listSentinelWatchEvents","summary":"Paginated watcher event history (30 days, free)","description":"Free. Requires X-Livecheck-Owner-Token. Returns change, unreachable, recovered, expiring, and expired events from the last 30 days. Query limit (default 50, max 100) and cursor (event id). Bad owner token → 403.","tags":["Sentinel","watch"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Watcher id (wtc_ + ULID)."},{"name":"X-Livecheck-Owner-Token","in":"header","required":true,"schema":{"type":"string"},"description":"owt_ token returned once on POST /v1/watch."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Event id (evt_). Returns events older than this id."}],"responses":{"200":{"description":"Paginated events with next_cursor when has_more"},"401":{"description":"Missing owner token"},"403":{"description":"Wrong owner token"},"404":{"description":"Unknown watcher or cursor"}}}},"/v1/confirm":{"post":{"operationId":"confirmLeadSubmit","summary":"Independently confirm lead_submit ($0.10) or listing_published ($0.10)","description":"POST {url, intent, claim?} after a side-effect. Payable intents on this route: lead_submit ($0.10) — thank-you/result page; confirmed only with a confirmation/ref/ticket/lead id (thank-you fluff alone is never confirmed). listing_published ($0.10) — specific job/product/eBay listing URL; claim.title/sku/id optional (match or veto; not required for L2). order_placed is not payable here — POST /v1/confirm/order ($0.25). Returns confirmed|failed|unknown with Level-2+ evidence. Independent cookieless verifier (actor ≠ verifier). Signed receipts: GET /v1/receipt/{id}. Keys: GET /.well-known/livecheck-keys.json. GET /stats publishes rolling counts and CI/local Confirm honesty benches (per-intent false_confirmed_rate + N); not a live dispute rate; missing ≠ live FC of 0. Not URL/stock liveness (use /v1/verify). Not Trust Oracle / L3. Unsupported intents → 400 unsupported_intent.","x-guidance":"POST {url, intent, claim?} after a side-effect. Payable intents on this route: lead_submit ($0.10) — thank-you/result page; confirmed only with a confirmation/ref/ticket/lead id (thank-you fluff alone is never confirmed). listing_published ($0.10) — specific job/product/eBay listing URL; claim.title/sku/id optional (match or veto; not required for L2). order_placed is not payable here — POST /v1/confirm/order ($0.25). Returns confirmed|failed|unknown with Level-2+ evidence. Independent cookieless verifier (actor ≠ verifier). Signed receipts: GET /v1/receipt/{id}. Keys: GET /.well-known/livecheck-keys.json. GET /stats publishes rolling counts and CI/local Confirm honesty benches (per-intent false_confirmed_rate + N); not a live dispute rate; missing ≠ live FC of 0. Not URL/stock liveness (use /v1/verify). Not Trust Oracle / L3. Unsupported intents → 400 unsupported_intent.","tags":["Confirm","lead_submit","side-effect"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL. lead_submit: thank-you or result page. listing_published: the specific job, product, or eBay item URL claimed to be live."},"intent":{"type":"string","enum":["lead_submit","listing_published"],"description":"Payable on this route: lead_submit ($0.10), listing_published ($0.10). listing_published claim.title/sku/id optional (match or veto; not required for L2). order_placed → 400 unsupported_intent (use POST /v1/confirm/order). Other values → 400 unsupported_intent."},"claim":{"type":"object","description":"Optional. Not required. lead_submit ignores claim. listing_published: title/sku/id may match or veto; not required for L2."}},"required":["url","intent"]},"example":{"url":"https://livecheck.fly.dev/demo/thank-you?ref=ABC123","intent":"lead_submit"}}}},"responses":{"200":{"description":"Independent confirmed, failed, or unknown verdict. Paid 200 includes watch suggest for POST /v1/watch.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Stable confirm id (cfm_ + ULID)."},"verdict":{"type":"string","enum":["confirmed","failed","unknown"]},"effect":{"type":"object","properties":{"type":{"type":"string","enum":["lead_submit","listing_published","order_placed"]},"id":{"type":"string"}},"required":["type"]},"evidence_strength":{"type":"number","enum":[1,2]},"evidence_level":{"type":"number","enum":[0,1,2,3,4]},"confidence":{"type":"number","minimum":0,"maximum":1},"signals":{"type":"array","items":{"type":"string"}},"independent_signals":{"type":"number"},"independent_evidence":{"type":"boolean"},"evidence_id":{"type":"string"},"http_status":{"type":"number"},"fetched_at":{"type":"string"},"url":{"type":"string"},"canonical_url":{"type":"string"},"price_usd":{"type":"number"},"route":{"type":"string","description":"API path that produced this response, after /v1/ and without a leading slash.","enum":["confirm","confirm/order"]},"receipt":{"type":"object","properties":{"hash":{"type":"string"},"signature":{"type":"string"},"signer":{"type":"string"},"verify_url":{"type":"string"}},"required":["hash","verify_url"]},"next_step":{"type":"object","properties":{"action":{"type":"string","enum":["human_review"]},"endpoint":{"type":"string","enum":["/v1/judge"]},"est_price_usd":{"type":"number"}},"description":"Present when verdict is unknown. /v1/judge is a 501 stub in this phase and is not payable."},"watch":{"type":"object","description":"Present on paid 200 Confirm responses, and on paid 200 Verify responses only when status is live (omitted on closed and unknown). Cross-sell hint to POST /v1/watch ($2.50, 30-day standard watcher). Default detector is status_change. Not included on unpaid 402.","properties":{"suggest":{"type":"string","enum":["/v1/watch"]},"detector":{"type":"string","enum":["status_change"]},"price_usd":{"type":"number"}},"required":["suggest","detector","price_usd"]}},"required":["id","verdict","effect","evidence_strength","evidence_level","confidence","signals","independent_signals","independent_evidence","evidence_id","http_status","fetched_at","url","canonical_url","price_usd","route","receipt"]}}}},"400":{"description":"unsupported_intent or invalid body. Payable intents: lead_submit, listing_published. order_placed → POST /v1/confirm/order."},"402":{"description":"Payment required. Fixed $0.10 USDC (100000 atomic)."}}}},"/v1/confirm/order":{"post":{"operationId":"confirmOrderPlaced","summary":"Independently confirm order_placed ($0.25)","description":"POST {url, intent: order_placed, claim?} after checkout. url is a thank-you/confirmation/order-status page; claim.order_id/total/email_domain optional (match or veto); thank-you fluff alone never confirmed; a durable order/confirmation/ref/ticket id is required for confirmed. Fixed $0.25 USDC. Returns confirmed|failed|unknown with Level-2+ evidence. Independent cookieless verifier (actor ≠ verifier). Signed receipts: GET /v1/receipt/{id}. lead_submit and listing_published stay on POST /v1/confirm ($0.10). Not Trust Oracle / L3. Other intents → 400 unsupported_intent.","x-guidance":"POST {url, intent: order_placed, claim?} after checkout. url is a thank-you/confirmation/order-status page; claim.order_id/total/email_domain optional (match or veto); thank-you fluff alone never confirmed; a durable order/confirmation/ref/ticket id is required for confirmed. Fixed $0.25 USDC. Returns confirmed|failed|unknown with Level-2+ evidence. Independent cookieless verifier (actor ≠ verifier). Signed receipts: GET /v1/receipt/{id}. lead_submit and listing_published stay on POST /v1/confirm ($0.10). Not Trust Oracle / L3. Other intents → 400 unsupported_intent.","tags":["Confirm","order_placed","side-effect"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL of the thank-you / confirmation / order-status page after checkout."},"intent":{"type":"string","enum":["order_placed"],"description":"Payable on this route: order_placed ($0.25). claim.order_id/total/etc optional; thank-you fluff alone never confirmed; durable order/confirmation/ref/ticket id required for confirmed. Other values → 400 unsupported_intent (lead_submit / listing_published use POST /v1/confirm)."},"claim":{"type":"object","description":"Optional. Not required. order_id/total/email_domain may match or veto; never invents ids; fluff-only pages stay unknown."}},"required":["url","intent"]}}}},"responses":{"200":{"description":"Independent confirmed, failed, or unknown verdict. Paid 200 includes watch suggest for POST /v1/watch.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Stable confirm id (cfm_ + ULID)."},"verdict":{"type":"string","enum":["confirmed","failed","unknown"]},"effect":{"type":"object","properties":{"type":{"type":"string","enum":["lead_submit","listing_published","order_placed"]},"id":{"type":"string"}},"required":["type"]},"evidence_strength":{"type":"number","enum":[1,2]},"evidence_level":{"type":"number","enum":[0,1,2,3,4]},"confidence":{"type":"number","minimum":0,"maximum":1},"signals":{"type":"array","items":{"type":"string"}},"independent_signals":{"type":"number"},"independent_evidence":{"type":"boolean"},"evidence_id":{"type":"string"},"http_status":{"type":"number"},"fetched_at":{"type":"string"},"url":{"type":"string"},"canonical_url":{"type":"string"},"price_usd":{"type":"number"},"route":{"type":"string","description":"API path that produced this response, after /v1/ and without a leading slash.","enum":["confirm","confirm/order"]},"receipt":{"type":"object","properties":{"hash":{"type":"string"},"signature":{"type":"string"},"signer":{"type":"string"},"verify_url":{"type":"string"}},"required":["hash","verify_url"]},"next_step":{"type":"object","properties":{"action":{"type":"string","enum":["human_review"]},"endpoint":{"type":"string","enum":["/v1/judge"]},"est_price_usd":{"type":"number"}},"description":"Present when verdict is unknown. /v1/judge is a 501 stub in this phase and is not payable."},"watch":{"type":"object","description":"Present on paid 200 Confirm responses, and on paid 200 Verify responses only when status is live (omitted on closed and unknown). Cross-sell hint to POST /v1/watch ($2.50, 30-day standard watcher). Default detector is status_change. Not included on unpaid 402.","properties":{"suggest":{"type":"string","enum":["/v1/watch"]},"detector":{"type":"string","enum":["status_change"]},"price_usd":{"type":"number"}},"required":["suggest","detector","price_usd"]}},"required":["id","verdict","effect","evidence_strength","evidence_level","confidence","signals","independent_signals","independent_evidence","evidence_id","http_status","fetched_at","url","canonical_url","price_usd","route","receipt"]}}}},"400":{"description":"unsupported_intent or invalid body. Payable intent: order_placed. lead_submit / listing_published → POST /v1/confirm."},"402":{"description":"Payment required. Fixed $0.25 USDC (250000 atomic)."}}}},"/v1/receipt/{id}":{"get":{"security":[],"operationId":"getConfirmReceipt","summary":"Fetch a Confirm receipt by id","description":"Free. Returns the stored receipt, canonical payload, and verify metadata. Accepts Confirm ids (cfm_), Sentinel check ids (chk_), watcher ids (wtc_), watch renew ids (wrn_), and watch event ids (evt_). Rows persist in receipts.sqlite on the same Fly volume as watchers and survive redeploy. Unsigned when CONFIRM_RECEIPT_PRIVATE_KEY is unset.","tags":["Confirm","Sentinel"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Confirm id (cfm_ + ULID), check id (chk_ + ULID), watcher id (wtc_ + ULID), renew id (wrn_ + ULID), or event id (evt_ + ULID)."}],"responses":{"200":{"description":"Receipt and verify metadata"},"404":{"description":"Unknown id"}}}},"/.well-known/livecheck-keys.json":{"get":{"security":[],"operationId":"livecheckKeys","summary":"Ed25519 public key for Confirm receipts","description":"Free JWKS-style document. keys is empty when signing is not configured.","tags":["Confirm"],"responses":{"200":{"description":"Public keys"}}}},"/stats":{"get":{"security":[],"operationId":"livecheckStats","summary":"Confirm and Sentinel counts","description":"Free. Confirm: lead_submit, listing_published, and order_placed rolling counts. benches publishes per-intent CI/local honesty false_confirmed_rate + N from bench/lead-submit-report.json, bench/listing-published-report.json, and bench/order-placed-report.json (hardcoded fallback if a report is missing). Not a live dispute rate — do not infer FC from paid_calls. paid_calls are intent-scoped confirm-route rows and are not invented from receipts. Public GET /stats is one machine (store.scope=this_machine_volume). unique_payers is COUNT(DISTINCT payer) in that SQLite file. LIVECHECK_STATS_FLEET=1 is the emergency multi-machine sum and withholds unique_payers (it does not add per-volume distincts). Unscoped pre-intent rows are not attributed to lead_submit. Sentinel active_watchers, checks_run, change_events, and by_detector are this volume unless that emergency flag is set. sentinel.benches publishes CI/local gate numbers from bench/sentinel-report.json (status_change/text_diff FP, latency p50/p95, HMAC, chain Verify) with a hardcoded fallback from main 590627c and is not summed. The outage gate outage_no_content_change is not in sentinel.benches; this is not a republish of that gate. Not a live dispute rate or 1000-watcher soak. Headline counts include internal test traffic; traffic.external omits configured team wallets and paid_calls to the public docs example URL (https://boards.greenhouse.io/example/jobs/1842). Those docs-example calls stay in traffic.all and are counted on traffic.docs_example. Not a payable route. Unpaid POST /v1/check, /v1/watch, and /v1/watch/renew 402s include extensions.bazaar.","tags":["Confirm","Sentinel"],"responses":{"200":{"description":"JSON stats (HTML when Accept: text/html)"}}}}}}