docs.vin

offer.instantCashOffer

InstantCashOffer — the commerce face of offer (transact it), at `POST /offers/instant-cash-offer`.

Promoted — earned, computed, recomputed on every regen

This capability earned a standalone page by the computed promotion function (2 of 4 signals): live on the wire + carries its own stateSet. Its frozen address never moved — /catalog/offer#instantCashOffer still answers as an anchored section on the noun page. Promotion is a regen event, not a meeting: lose the signals and this page folds back to the anchor while the redirect map retargets automatically.

Live

The acceptance suite is green. This capability answers on the wire today.

Noun offer · Pillar Commerce

Descriptor

The catalog row, rendered. This is the same descriptor that answers GET /catalog?select=….

FieldValue
Nounoffer
FacetCommerce
Sidedemand
PillarCommerce
Kindact
Statuslive
Gatekey
Mandatenone
Pricenot posted — see /pricing
Dooraggregator

The two spellings

One capability, two addresses — generated from one descriptor, so they cannot disagree:

  • The catalog nameoffer.instantCashOffer. What the SDK, the CLI, and the MCP index call it.
  • The wire routePOST /offers/instant-cash-offer. What HTTP calls it.

Call it

the SDK — offer.instantCashOffer
import { offer } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await offer.instantCashOffer()
POST /offers/instant-cash-offer
curl -X POST https://apis.vin/offers/instant-cash-offer \
  -H 'content-type: application/json' \
  -d '{}'

Input

No input — this capability takes no request body.

Answers

A typed OK envelope carrying OfferInstantCashOffer@1. Every fact inside it is an evidence object — { value, source, timestamp, verification } — and act-minted facts carry a dereferenceable pointer to the event that minted them. Absence is typed (EMPTY), never a faked 200.

The gate

This capability is keyed — mint an anonymous key with POST /keys; no account, no email.

The door

aggregator.vin serves this noun on its two routes: / (the landing) · /1GTZ7HFP3P1229718 (the VIN lens).

Try it

Live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

Emits

On success this capability appends to the record and emits:

Subscribe on the universal /webhooks rail, or replay from the subject snapshot.

Data model

Backs the Offer entity. See the schema, relationships, and state set on offer and in the data model.


Generated from the catalog descriptor. It shows only what the descriptor declares — the provider behind a fact is never named here; evidence source names the attesting authority at the estate's own level of abstraction.