watch

Return the monitoring receipt for one period: valid checks, attempts that returned nothing, recoveries, and confirmed Signals.

Return the monitoring receipt for one period: valid checks, attempts that returned nothing, recoveries, and confirmed Signals.

When to use. Use to answer whether anything a person watches changed in a period, and what monitoring did in the period whether or not anything did.

What it cannot provide. A count of valid checks is not a claim that a product held still. It reports no candidate, no source URL and no internal identifier, and a period the monitoring ledger does not reach is reported as partly covered rather than as zero.

Requires the watch:manage scope. Each distinct product named in a successful answer spends one unit of the key's daily product budget. Asking twice about the same one costs once.

get/api/v1/watch/receipt

Request

  • Base URL: https://formulasignal.com
  • URL: https://formulasignal.com/api/v1/watch/receipt
  • Auth: HTTP bearer

Query parameters

periodstring

Headers

X-FormulaSignal-Origin'api' | 'mcp'

Optional attribution: mcp when the call comes from the FormulaSignal MCP server, api otherwise. Self-reported and recorded on the usage row so a customer can see which surface their traffic came from. Nothing reads it to decide what a caller may do, so a wrong value costs only the accuracy of that customer's own reporting.

Response

A FormulaSignal answer. status says what kind of answer it is, and every value except supported is still a real answer about the Record rather than a fact about the product.

request_idstring required
capabilitystring required
status'supported' | 'partial' | 'stale' | 'under_review' | 'ambiguous' | 'unsupported' | 'refused' required

What kind of answer this is. Every value except supported is still a real answer about the Record rather than a fact about the product.

summarystring required

One sentence saying what kind of answer this is.

signalsobject[]
comparisonobject
coverageobject
ledgerobject
watchobject
next_cursorstring nullable
limitationsstring[] required

Always present, including when empty. Read it.

record_versionstring required

The Record data-state id. Two answers sharing it came from one committed state.

record_as_ofstring date required
record_timestampstring date-time required

The newest dated observation the Record holds. Deliberately not "now".

methodology_versionstring required
disclaimerstring required

Example response

{
  "methodology_version": "record-v1",
  "disclaimer": "FormulaSignal provides evidence-backed supplement information and does not provide individualized medical advice."
}

Changes

No recorded changes to this operation across all 1 revision of this API.