docs.vin

partCatalog

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

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

Identity

NounpartCatalog
PillarData (facets: 6 data · 2 services · 2 commerce)
Capabilities10 — 0 live · 10 sandbox · 0 declared
EntitiesPart
Doorsaggregator.vin
SDKVin.partCatalog.* from apis.vin
Address/catalog/partCatalog#{action} — the anchor IS the wire name minus partCatalog.

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

partCatalog.search · GET /part-catalogs/search · gate none · sandbox · answers PartCatalogSearch@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.search
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.search({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/search
curl 'https://apis.vin/part-catalogs/search?vin=1C6RRFFG7PN674929'

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:15.018Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogSearch@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "matches": [
      {
        "partNumber": "P-c6d18dea",
        "unitCents": 24000
      }
    ],
    "count": 1
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "matches": [
      {
        "partNumber": "P-c6d18dea",
        "unitCents": 24000
      }
    ],
    "count": 1
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

validateFitment

partCatalog.validateFitment · POST /part-catalogs/validate-fitment · gate offer · sandbox · answers PartCatalogValidateFitment@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) · /1C6RRFFG7PN674929 (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 — PartCatalog.validateFitmentRequested@1 · PartCatalog.fitmentValidated@1.

the SDK — partCatalog.validateFitment
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.validateFitment({"vin":"1C6RRFFG7PN674929"})
POST /part-catalogs/validate-fitment
curl -X POST https://apis.vin/part-catalogs/validate-fitment \
  -H 'content-type: application/json' \
  -d '{"vin":"1C6RRFFG7PN674929"}'

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:15.018Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogValidateFitment@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "fitment": {
      "fits": true,
      "status": "fits",
      "partNumber": "P-c6d18dea",
      "basis": "oe-book"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "fitment": {
      "fits": true,
      "status": "fits",
      "partNumber": "P-c6d18dea",
      "basis": "oe-book"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

partCatalog.quote · POST /part-catalogs/quote · gate offer · sandbox · answers PartCatalogQuote@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) · /1C6RRFFG7PN674929 (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 — PartCatalog.quoteRequested@1 · PartCatalog.quoted@1.

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

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

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:15.011Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogQuote@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "quote": {
      "id": "PQ-ebce2148",
      "amountCents": 24000,
      "basis": "oe-book"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "quote": {
      "id": "PQ-ebce2148",
      "amountCents": 24000,
      "basis": "oe-book"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

partCatalog.order · POST /part-catalogs/order · gate offer · sandbox · answers PartCatalogOrder@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) · /1C6RRFFG7PN674929 (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 — PartCatalog.completed@1 · PartCatalog.dispatched@1 · PartCatalog.ordered@1 · ServiceOrder.settled@1.

the SDK — partCatalog.order
import { partCatalog } from 'apis.vin'

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

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogOrder@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "order": {
      "status": "placed",
      "amountCents": 24000,
      "position": "Ordered"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "order": {
      "status": "placed",
      "amountCents": 24000,
      "position": "Ordered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

buildCart

partCatalog.buildCart · POST /part-catalogs/build-cart · gate offer · sandbox · answers PartCatalogBuildCart@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) · /1C6RRFFG7PN674929 (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 — PartCatalog.buildCartRequested@1 · PartCatalog.cartBuilt@1.

the SDK — partCatalog.buildCart
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.buildCart({"vin":"1C6RRFFG7PN674929"})
POST /part-catalogs/build-cart
curl -X POST https://apis.vin/part-catalogs/build-cart \
  -H 'content-type: application/json' \
  -d '{"vin":"1C6RRFFG7PN674929"}'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogBuildCart@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "cart": {
      "id": "CART-aff56b92",
      "lines": [
        {
          "partNumber": "P-c6d18dea",
          "unitCents": 24000
        }
      ],
      "totalCents": 24000
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "cart": {
      "id": "CART-aff56b92",
      "lines": [
        {
          "partNumber": "P-c6d18dea",
          "unitCents": 24000
        }
      ],
      "totalCents": 24000
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

compatible

partCatalog.compatible · GET /part-catalogs/compatible · gate none · sandbox · answers PartCatalogCompatible@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.compatible
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.compatible({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/compatible
curl 'https://apis.vin/part-catalogs/compatible?vin=1C6RRFFG7PN674929'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogCompatible@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "fitment": {
      "fits": true,
      "status": "fits",
      "partNumber": "P-c6d18dea",
      "basis": "oe-book"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "fitment": {
      "fits": true,
      "status": "fits",
      "partNumber": "P-c6d18dea",
      "basis": "oe-book"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

decodeVin

partCatalog.decodeVin · GET /part-catalogs/decode-vin · gate none · sandbox · answers PartCatalogDecodeVin@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.decodeVin
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.decodeVin({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/decode-vin
curl 'https://apis.vin/part-catalogs/decode-vin?vin=1C6RRFFG7PN674929'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogDecodeVin@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "decode": {
      "catalogKey": "CATKEY-18e3a27b",
      "partNumber": "P-c6d18dea"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "decode": {
      "catalogKey": "CATKEY-18e3a27b",
      "partNumber": "P-c6d18dea"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

diagram

partCatalog.diagram · GET /part-catalogs/diagram · gate none · sandbox · answers PartCatalogDiagram@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.diagram
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.diagram({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/diagram
curl 'https://apis.vin/part-catalogs/diagram?vin=1C6RRFFG7PN674929'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogDiagram@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "plate": {
      "id": "PLT-502dc118",
      "partNumber": "P-c6d18dea",
      "view": "exploded"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "plate": {
      "id": "PLT-502dc118",
      "partNumber": "P-c6d18dea",
      "view": "exploded"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

explodedView

partCatalog.explodedView · GET /part-catalogs/exploded-view · gate none · sandbox · answers PartCatalogExplodedView@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.explodedView
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.explodedView({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/exploded-view
curl 'https://apis.vin/part-catalogs/exploded-view?vin=1C6RRFFG7PN674929'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogExplodedView@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "plate": {
      "id": "PLT-502dc118",
      "partNumber": "P-c6d18dea",
      "view": "exploded"
    }
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "plate": {
      "id": "PLT-502dc118",
      "partNumber": "P-c6d18dea",
      "view": "exploded"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

filter

partCatalog.filter · GET /part-catalogs/filter · gate none · sandbox · answers PartCatalogFilter@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1C6RRFFG7PN674929 (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 — partCatalog.filter
import { partCatalog } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await partCatalog.filter({"vin":"1C6RRFFG7PN674929"})
GET /part-catalogs/filter
curl 'https://apis.vin/part-catalogs/filter?vin=1C6RRFFG7PN674929'

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:15.009Z · HTTP 200
{
  "type": "OK",
  "answers": "PartCatalogFilter@1",
  "value": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "matches": [
      {
        "partNumber": "P-c6d18dea",
        "unitCents": 24000
      }
    ],
    "count": 1
  },
  "evidence": {
    "vin": "1C6RRFFG7PN674929",
    "noun": "partCatalog",
    "asOf": "2026-08-10",
    "id": "PRT-32e9fb67",
    "partNumber": "P-c6d18dea",
    "repairOrderId": "RO-370b61c0",
    "price": 24000,
    "status": "Ordered",
    "matches": [
      {
        "partNumber": "P-c6d18dea",
        "unitCents": 24000
      }
    ],
    "count": 1
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "parts-shelf-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.

Part

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

part

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

party

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

On this page

Identity
Events
Discover & read
search
validateFitment
Quote & price
quote
Apply & book
order
More actions
buildCart
compatible
decodeVin
diagram
explodedView
filter
Data model
Part