Settlement API · v1
In development. Live settlement is switched off until counsel review is complete. Live jobs, proof and verdicts run, and every live release is held. Test keys run the whole flow in the sandbox.
Create the job
Your Work Spec: the site, the owner, your reference, and each step with its kind and its pay.
POST /settlement/jobs
settlement.job_created
Send proof per step
Photo fingerprints from your app, readings, an inspection result. Per step, as the work happens.
POST /jobs/{id}/steps/{step}/proof
settlement.step_review
It's verified
The Verification Oracle judges it on the step kind's standard. Where it can't decide alone, a person at 4 Seasons does.
GET /settlement/jobs/{id}
settlement.step_verified
Pay is released
Over our rails, from your funded balance, once per verified step, with the lien waiver and the signed Work Record.
GET /settlement/releases
settlement.release_sent
Money moves only on a verified step
One release per verified step, never on proof alone. A step sent back pays nothing until new proof is verified.
Never paid twice
Each release goes to the rail with the same key on every try. Retries of your own calls take an Idempotency-Key.
1% of settled pay
The fee is a share of each released step, on top of the pay. Nothing per seat, per key or per lead.
Held to Find and stop a leak task.leak-repair v1
Done by Sample Plumbing Co
$200.00
What the standard asks for, and what came
Where the water was coming from
Photo · Received · 1 photo, fingerprinted
The repair, dry
Photo · Received · 1 photo, fingerprinted
Dry after 10 minutes with the water on
Standard · Met
Damaged area photographed for the homeowner
Standard · Met
The 2 photos judged came as SHA-256 fingerprints from your app, 2 with a location. We keep the fingerprints, so anyone holding a file can show it is the one judged. Our camera checks don't run on files we don't hold, so the reviewer who accepted it looked at what they couldn't.
The release decision
Decided by Sandbox reviewer on Nov 10, 9:04 AM, against rule oracle-1/task.leak-repair@1/r1.
One round of proof
Accepted · Sandbox reviewer · Nov 10, 9:04 AM
2 photos, 0 readings
Pay
$200.00
Fee
$2.00
Rail
Stripe
Money
Sent Nov 10, 9:04 AM
Held to Final building inspection inspection.final-building v1
Done by Sample Plumbing Co
$75.00
What the standard asks for, and what came
Inspection card or result
Photo · Received · 1 photo, fingerprinted
The inspector's result
Inspection · Met · Passed, Sample County inspector
Passed by the inspector
Standard · Met
Every correction fixed, photographed and accepted
Standard · Met
The photo judged came as SHA-256 fingerprints from your app, 1 with a location. We keep the fingerprints, so anyone holding a file can show it is the one judged. Our camera checks don't run on files we don't hold, so a person looks at what they can't.
The release decision
Decided by the Verification Oracle on Nov 10, 9:04 AM, against rule oracle-1/inspection.final-building@1/r1, confidence 1.00.
One round of proof
Accepted · the Oracle · Nov 10, 9:04 AM
1 photo, 0 readings · The inspector's result moves an inspection; the oracle only records it
Pay
$75.00
Fee
$0.75
Rail
Stripe
Money
Sent Nov 10, 9:04 AM
The step
open Waiting for proof
pending Waiting on evidence
review A person is checking
rejected Sent back for more proof
The release, once the step is verified
verified Verified
held Held
sending On its way
404 not_found, the same as something that doesn't exist.livemode.POST /api/v1/work-records/verify.