docs.vin

wholesaleQuote

The wholesaleQuote noun — identity, lifecycle, events, and every capability as an anchored section: 12 capabilities, 0 live, 12 sandbox, 0 declared.

wholesaleQuote is one of the estate's 317 automotive nouns — a job a car needs done. It carries 12 capabilities: 0 live, 12 sandbox, 0 declared · doors aggregator.vin.

Identity

NounwholesaleQuote
PillarServices (facets: 3 data · 5 services · 4 commerce)
Capabilities12 — 0 live · 12 sandbox · 0 declared
EntitiesOffer
Doorsaggregator.vin
SDKVin.wholesaleQuote.* from apis.vin
Address/catalog/wholesaleQuote#{action} — the anchor IS the wire name minus wholesaleQuote.

Events

The vocabulary this noun can append to the record — 10 past-tense, versioned event types, each linked to the capability that emits it:

Discover & read

read

wholesaleQuote.read · GET /wholesale-quotes/read · gate none · sandbox · answers WholesaleQuoteRead@1

FieldTypeRequiredNotes
vinstringno—

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — wholesaleQuote.read
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.read({"vin":"1C4AJWAGXHL680337"})
GET /wholesale-quotes/read
curl 'https://apis.vin/wholesale-quotes/read?vin=1C4AJWAGXHL680337'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.206Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteRead@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "quote": {
      "id": "OFR-2f40589a",
      "position": "Extended",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure-the-wholesale-mark"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "quote": {
      "id": "OFR-2f40589a",
      "position": "Extended",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure-the-wholesale-mark"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

wholesaleQuote.quote · POST /wholesale-quotes/quote · gate offer · sandbox · answers WholesaleQuoteQuote@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.failed@1 · WholesaleQuote.quoted@1.

the SDK — wholesaleQuote.quote
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.quote({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/quote
curl -X POST https://apis.vin/wholesale-quotes/quote \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.206Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteQuote@1",
  "value": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "channel": "wholesale",
    "quote": {
      "amount": "17395.00",
      "currency": "USD"
    },
    "floor": {
      "amount": "5874.00",
      "currency": "USD"
    },
    "validForDays": 3,
    "validUntil": "2026-08-10",
    "basis": "wholesale-basis",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "channel": "wholesale",
    "quote": {
      "amount": "17395.00",
      "currency": "USD"
    },
    "floor": {
      "amount": "5874.00",
      "currency": "USD"
    },
    "validForDays": 3,
    "validUntil": "2026-08-10",
    "basis": "wholesale-basis",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "market-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

appraise

wholesaleQuote.appraise · POST /wholesale-quotes/appraise · gate offer · sandbox · answers WholesaleQuoteAppraise@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.appraised@1 · WholesaleQuote.requested@1.

the SDK — wholesaleQuote.appraise
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.appraise({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/appraise
curl -X POST https://apis.vin/wholesale-quotes/appraise \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.202Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteAppraise@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "appraisal": {
      "status": "appraised",
      "id": "OFR-2f40589a",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "appraisal": {
      "status": "appraised",
      "id": "OFR-2f40589a",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

value

wholesaleQuote.value · GET /wholesale-quotes/value · gate key · sandbox · answers WholesaleQuoteValue@1

FieldTypeRequiredNotes
vinstringno—

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — wholesaleQuote.value
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.value({"vin":"1C4AJWAGXHL680337"})
GET /wholesale-quotes/value
curl 'https://apis.vin/wholesale-quotes/value?vin=1C4AJWAGXHL680337'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.217Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteValue@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "valuation": {
      "status": "valued",
      "id": "OFR-2f40589a",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "valuation": {
      "status": "valued",
      "id": "OFR-2f40589a",
      "amountCents": 1850000,
      "currency": "USD",
      "basis": "acquisition-figure"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

request

wholesaleQuote.request · POST /wholesale-quotes/request · gate offer · sandbox · answers WholesaleQuoteRequest@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.requested@1.

the SDK — wholesaleQuote.request
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.request({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/request
curl -X POST https://apis.vin/wholesale-quotes/request \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.209Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteRequest@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "request": {
      "status": "already-on-file",
      "id": "OFR-2f40589a",
      "position": "Extended"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "request": {
      "status": "already-on-file",
      "id": "OFR-2f40589a",
      "position": "Extended"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

wholesaleQuote.pay · POST /wholesale-quotes/pay · gate offer · sandbox · answers WholesaleQuotePay@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.failed@1 · WholesaleQuote.paid@1.

the SDK — wholesaleQuote.pay
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.pay({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/pay
curl -X POST https://apis.vin/wholesale-quotes/pay \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.205Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuotePay@1",
  "value": {
    "payment": {
      "$type": "InvoicePayment",
      "$id": "invoicepayment_pay_1",
      "invoiceId": "invoice_in_1",
      "amount": {
        "amount": "2200000",
        "currency": "USD"
      },
      "status": "pending",
      "scheme": "ach",
      "paidAt": "2026-08-10T00:00:00.000Z",
      "provenance": {
        "environment": "sandbox",
        "simulated": true,
        "provider": "invoicing-rail"
      },
      "providerData": {
        "externalId": "pay_1"
      }
    }
  },
  "evidence": {
    "payment": {
      "$type": "InvoicePayment",
      "$id": "invoicepayment_pay_1",
      "invoiceId": "invoice_in_1",
      "amount": {
        "amount": "2200000",
        "currency": "USD"
      },
      "status": "pending",
      "scheme": "ach",
      "paidAt": "2026-08-10T00:00:00.000Z",
      "provenance": {
        "environment": "sandbox",
        "simulated": true,
        "provider": "invoicing-rail"
      },
      "providerData": {
        "externalId": "pay_1"
      }
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "invoicing-rail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

settle

wholesaleQuote.settle · POST /wholesale-quotes/settle · gate offer · sandbox · answers WholesaleQuoteSettle@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.failed@1 · WholesaleQuote.settled@1.

the SDK — wholesaleQuote.settle
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.settle({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/settle
curl -X POST https://apis.vin/wholesale-quotes/settle \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.209Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteSettle@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "settlement": {
      "status": "not-accepted",
      "id": "OFR-2f40589a",
      "position": "Extended"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "settlement": {
      "status": "not-accepted",
      "id": "OFR-2f40589a",
      "position": "Extended"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

generate

wholesaleQuote.generate · POST /wholesale-quotes/generate · gate offer · sandbox · answers WholesaleQuoteGenerate@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.generated@1.

the SDK — wholesaleQuote.generate
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.generate({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/generate
curl -X POST https://apis.vin/wholesale-quotes/generate \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.202Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteGenerate@1",
  "value": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "channel": "wholesale",
    "quote": {
      "amount": "17395.00",
      "currency": "USD"
    },
    "floor": {
      "amount": "5874.00",
      "currency": "USD"
    },
    "validUntil": "2026-08-10",
    "basis": "wholesale-basis",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "channel": "wholesale",
    "quote": {
      "amount": "17395.00",
      "currency": "USD"
    },
    "floor": {
      "amount": "5874.00",
      "currency": "USD"
    },
    "validUntil": "2026-08-10",
    "basis": "wholesale-basis",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "market-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

accept

wholesaleQuote.accept · POST /wholesale-quotes/accept · gate offer · sandbox · answers WholesaleQuoteAccept@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.accepted@1 · WholesaleQuote.failed@1.

the SDK — wholesaleQuote.accept
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.accept({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/accept
curl -X POST https://apis.vin/wholesale-quotes/accept \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.202Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteAccept@1",
  "value": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "state": "accepted",
    "confirmationRef": "WQA-0CC7EBW",
    "settlementDueDays": 2,
    "asOf": "2026-08-10"
  },
  "evidence": {
    "quoteId": "WQ-1HO09TE",
    "vin": "1C4AJWAGXHL680337",
    "state": "accepted",
    "confirmationRef": "WQA-0CC7EBW",
    "settlementDueDays": 2,
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "market-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Lifecycle & state

expire

wholesaleQuote.expire · POST /wholesale-quotes/expire · gate offer · sandbox · answers WholesaleQuoteExpire@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.expired@1.

the SDK — wholesaleQuote.expire
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.expire({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/expire
curl -X POST https://apis.vin/wholesale-quotes/expire \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.202Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteExpire@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "expiry": {
      "id": "OFR-2f40589a",
      "expires": true,
      "expiresOn": "2026-08-17",
      "position": "Extended"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "expiry": {
      "id": "OFR-2f40589a",
      "expires": true,
      "expiresOn": "2026-08-17",
      "position": "Extended"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

comps

wholesaleQuote.comps · GET /wholesale-quotes/comps · gate key · sandbox · answers WholesaleQuoteComps@1

FieldTypeRequiredNotes
vinstringno—

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — wholesaleQuote.comps
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.comps({"vin":"1C4AJWAGXHL680337"})
GET /wholesale-quotes/comps
curl 'https://apis.vin/wholesale-quotes/comps?vin=1C4AJWAGXHL680337'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.202Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteComps@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "compCount": 4,
    "comps": [
      {
        "compRef": "CMP-0W3NBFG",
        "price": {
          "amount": "17322.00",
          "currency": "USD"
        },
        "soldDaysAgo": 41
      },
      {
        "compRef": "CMP-0WDMX4F",
        "price": {
          "amount": "16145.00",
          "currency": "USD"
        },
        "soldDaysAgo": 44
      },
      {
        "compRef": "CMP-0WNMITE",
        "price": {
          "amount": "14968.00",
          "currency": "USD"
        },
        "soldDaysAgo": 20
      },
      {
        "compRef": "CMP-0WXM4ID",
        "price": {
          "amount": "19792.00",
          "currency": "USD"
        },
        "soldDaysAgo": 19
      }
    ],
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "compCount": 4,
    "comps": [
      {
        "compRef": "CMP-0W3NBFG",
        "price": {
          "amount": "17322.00",
          "currency": "USD"
        },
        "soldDaysAgo": 41
      },
      {
        "compRef": "CMP-0WDMX4F",
        "price": {
          "amount": "16145.00",
          "currency": "USD"
        },
        "soldDaysAgo": 44
      },
      {
        "compRef": "CMP-0WNMITE",
        "price": {
          "amount": "14968.00",
          "currency": "USD"
        },
        "soldDaysAgo": 20
      },
      {
        "compRef": "CMP-0WXM4ID",
        "price": {
          "amount": "19792.00",
          "currency": "USD"
        },
        "soldDaysAgo": 19
      }
    ],
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "market-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

honor

wholesaleQuote.honor · POST /wholesale-quotes/honor · gate offer · sandbox · answers WholesaleQuoteHonor@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

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

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — WholesaleQuote.honored@1.

the SDK — wholesaleQuote.honor
import { wholesaleQuote } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await wholesaleQuote.honor({"vin":"1C4AJWAGXHL680337"})
POST /wholesale-quotes/honor
curl -X POST https://apis.vin/wholesale-quotes/honor \
  -H 'content-type: application/json' \
  -d '{"vin":"1C4AJWAGXHL680337"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:19.205Z · HTTP 200
{
  "type": "OK",
  "answers": "WholesaleQuoteHonor@1",
  "value": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "honor": {
      "status": "not-accepted",
      "id": "OFR-2f40589a",
      "position": "Extended"
    }
  },
  "evidence": {
    "vin": "1C4AJWAGXHL680337",
    "noun": "wholesaleQuote",
    "asOf": "2026-08-10",
    "offerId": "OFR-2f40589a",
    "amount": 1850000,
    "netToSeller": 235763,
    "payoffId": "poq_4cf676ee",
    "status": "Extended",
    "expiresAt": "2026-08-17",
    "honor": {
      "status": "not-accepted",
      "id": "OFR-2f40589a",
      "position": "Extended"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wholesale-window-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Data model

The record shape behind this noun — one entity, each property an evidence field. See the whole estate model on the data model page.

Offer

Modeled

The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. 6 diagrams, rendered from the estate model.

WholesaleQuote · Class model

WholesaleQuote · State machine

WholesaleQuote · Sequence

WholesaleQuote · Class model

WholesaleQuote · State machine

WholesaleQuote · State machine

Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.

webhook

The webhook noun — identity, lifecycle, events, and every capability as an anchored section: 11 capabilities, 0 live, 11 sandbox, 0 declared.

windowTint

The windowTint noun — identity, lifecycle, events, and every capability as an anchored section: 9 capabilities, 0 live, 9 sandbox, 0 declared.

On this page

Identity
Events
Discover & read
read
Quote & price
quote
appraise
value
Apply & book
request
Pay & settle
pay
settle
Fulfill & operate
generate
Authorize & resolve
accept
Lifecycle & state
expire
More actions
comps
honor
Data model
Offer
Modeled