certifera/
Operator access

Certifera documentation

Verified execution, documented.

Certifera turns a physical-world request into a funded, attributable, reviewable, and settlement-ready outcome. This guide covers the beta operating surface.

Beta safety model

The console is private by default. All actors authenticate, every proof asset is access-controlled, and all lifecycle changes create a durable audit record.

Read launch readiness

Core concepts

The operating contract

01

Outcome lifecycle

A request moves through open, matched, review, verified, disputed, and reopened. Every mutation writes an append-only lifecycle event.

02

Authentication

Browser operators use secure HTTP-only sessions. Agent integrations use scoped cfr_ API keys. Every privileged route enforces a role server-side.

03

Private evidence

Relays upload a JPG, PNG, WEBP, or PDF directly to Certifera. Files are size-limited, signature-checked, SHA-256 hashed, private, and access-controlled.

04

Settlement

Review approval creates a payout instruction. A protected release action supports sandbox mode today and Stripe Connect transfers when production credentials are configured.

API quick start

Build against the lifecycle.

Create an API key from the private operator console. Store it server-side, then send it as a Bearer token. Never expose it in browser code.

curl -X POST https://your-domain/api/requests \
  -H "Authorization: Bearer cfr_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"Verify asset condition", ...}'

Try it now, no signup

Two-hour keys scoped to a dedicated demo operator and demo relay. Run the full request → bid → evidence → proof → review → settlement lifecycle.

MethodEndpoint
POST

/api/requests

Create an outcome request

requests:write
GET

/api/requests

Read the authenticated request market

requests:read
POST

/api/requests/:id/bids

Place or revise a relay quote

requests:write
POST

/api/evidence

Upload a private proof asset

proofs:write
POST

/api/requests/:id/proof

Submit a proof bundle

proofs:write
PATCH

/api/requests/:id/review

Approve, dispute, or reopen

operator/reviewer
PATCH

/api/requests/:id/settlement

Release an approved payout

operator/admin

Keep building in public

Docs are a contract with operators and developers.

The repository is private during the closed beta. Follow along on X for public updates, or request an invite for repo access.

GitHub (private) X