{"openapi":"3.1.0","info":{"title":"SignalWharf — restaurant provider observations","version":"0.2.0","description":"Dated provider URLs observed on a 20-site public restaurant website watchlist. Source evidence and coverage status included; not verified vendor contracts.","contact":{"name":"SignalWharf","email":"signalwharf@gmail.com","url":"https://signalwharf-beta.signalwharf.workers.dev"}},"servers":[{"url":"https://signalwharf-beta.signalwharf.workers.dev"}],"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 signed payment on Base. First request receives PAYMENT-REQUIRED challenge."}}},"paths":{"/v1/watchlist":{"get":{"operationId":"getCoverage","summary":"Supported sites and current purchase availability","security":[],"responses":{"200":{"description":"Watchlist and coverage status"}}}},"/v1/sample":{"get":{"operationId":"getFreeSample","summary":"Free real Canlis provider observation","security":[],"responses":{"200":{"description":"Fresh real sample","content":{"application/json":{"schema":{"type":"object","properties":{"beta":{"type":"boolean"},"site_id":{"type":"string"},"observation":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string"}},"checked_at":{"type":"string","format":"date-time"},"source_url":{"type":"string","format":"uri"},"evidence":{"type":"array","items":{"type":"object"}}}},"latest_collection":{"type":"object"},"freshness":{"type":"object"},"change_candidates":{"type":"array","items":{"type":"object"}},"caveats":{"type":"array","items":{"type":"string"}}}}}}},"503":{"description":"Fresh sample unavailable"}}}},"/v1/providers":{"get":{"operationId":"getProviderObservation","summary":"Buy one dated restaurant provider observation","description":"Watchlist only. Data must have recognized provider evidence and be no older than 48 hours. Failed checks and unverified change candidates are disclosed. No payment is requested for unavailable, stale, or empty observations.","security":[{"x402":[]}],"parameters":[{"name":"site","in":"query","required":true,"description":"Business id from /v1/watchlist.","schema":{"type":"string","enum":["wooden-city","en-rama","over-the-moon","spinasse","pink-door","cafe-juanita","musang","kamonegi","canlis","communion","walrus","bar-rosa","revel","cuerno-bravo","lark","macalusos","rockcreek","altura","relay","jeffrys"]},"example":"canlis"}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","paymentCurrency":"USDC"},"responses":{"200":{"description":"Dated observation, source evidence, freshness and any unverified candidates","content":{"application/json":{"schema":{"type":"object","properties":{"beta":{"type":"boolean"},"site_id":{"type":"string"},"observation":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string"}},"checked_at":{"type":"string","format":"date-time"},"source_url":{"type":"string","format":"uri"},"evidence":{"type":"array","items":{"type":"object"}}}},"latest_collection":{"type":"object"},"freshness":{"type":"object"},"change_candidates":{"type":"array","items":{"type":"object"}},"caveats":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Missing or unsupported site for a payment-bearing request"},"402":{"description":"x402 payment challenge; inspect PAYMENT-REQUIRED","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements","schema":{"type":"string"}}}},"422":{"description":"No recognized provider evidence; no payment requested"},"503":{"description":"Missing/stale observation or service unavailable; data checked before payment"}}}}}}