Skip to main content
POST
Fresh rows from the same URL, at marginal cost, with a diff

Authorizations

Authorization
string
header
required

fn_live_… or fn_test_… — Authorization: Bearer

Headers

fn-version
string

Dated API version; defaults to the account pin. Honesty note: with one version in existence the gateway echoes any value back as effective WITHOUT validating it — validation against the known-versions set is planned, so send only real dated versions from https://docs.fiveninelabs.com/changelog

Example:

"2026-08-26"

Idempotency-Key
string

24h replay window; a retry never bills twice

Maximum string length: 255

Path Parameters

id
string
required

Body

application/json
max_spend_usd
number
required
max_age_s
integer

sources/results younger than this serve from record at $0

sources
string[]

sessions only: restrict to these domains

Response

The refresh extraction; carries diff vs the refreshed-from result on delivery

id
string
required
Example:

"ext_6b1st"

object
string
required
Allowed value: "extraction"
status
string
required

running | delivered | abstained | error | stopped (open enum)

url
string
required
entity
string
claim
string

complete | partial — the receipt's claim, stated

records
integer
spend_usd
number
receipt_id
string
refresh_of
string

set when created by …/refresh

served_from
string

record — when max_age_s satisfied the refresh at $0

diff
object

refreshes only — vs the refreshed-from delivery

created_at
string<date-time>