safety
The safety noun — identity, lifecycle, events, and every capability as an anchored section: 6 capabilities, 0 live, 6 sandbox, 0 declared.
safety is one of the estate's 317 automotive nouns — a job a car needs done. It carries 6 capabilities: 0 live, 6 sandbox, 0 declared · doors safety.vin.
Identity
| Noun | safety |
| Pillar | Data (facets: 5 data · 1 commerce) |
| Capabilities | 6 — 0 live · 6 sandbox · 0 declared |
| Entities | VehicleRecord |
| Doors | safety.vin |
| SDK | Vin.safety.* from apis.vin |
| Address | /catalog/safety#{action} — the anchor IS the wire name minus safety. |
Events
The vocabulary this noun can append to the record — 1 past-tense, versioned event type, each linked to the capability that emits it:
Safety.subscribed@1— emitted bysubscribe
Discover & read
complaintLookup
safety.complaintLookup · GET /safeties/complaint-lookup · gate none · sandbox · answers SafetyComplaintLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.complaintLookup({"vin":"7FARW2H82ME010827"})curl 'https://apis.vin/safeties/complaint-lookup?vin=7FARW2H82ME010827'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.
{
"type": "OK",
"answers": "SafetyComplaintLookup@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"complaints": [],
"count": 0,
"status": "none-on-record",
"basis": "one-accident-fact"
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"complaints": [],
"count": 0,
"status": "none-on-record",
"basis": "one-accident-fact"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}crashTestLookup
safety.crashTestLookup · GET /safeties/crash-test-lookup · gate none · sandbox · answers SafetyCrashTestLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.crashTestLookup({"vin":"7FARW2H82ME010827"})curl 'https://apis.vin/safeties/crash-test-lookup?vin=7FARW2H82ME010827'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.
{
"type": "OK",
"answers": "SafetyCrashTestLookup@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"program": "government-crash-test-program"
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"program": "government-crash-test-program"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}iihsLookup
safety.iihsLookup · GET /safeties/iihs-lookup · gate none · sandbox · answers SafetyIihsLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.iihsLookup({"vin":"7FARW2H82ME010827"})curl 'https://apis.vin/safeties/iihs-lookup?vin=7FARW2H82ME010827'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.
{
"type": "OK",
"answers": "SafetyIihsLookup@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"institute": "IIHS",
"award": "acceptable"
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"institute": "IIHS",
"award": "acceptable"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}nhtsaLookup
safety.nhtsaLookup · GET /safeties/nhtsa-lookup · gate none · sandbox · answers SafetyNhtsaLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.nhtsaLookup({"vin":"7FARW2H82ME010827"})curl 'https://apis.vin/safeties/nhtsa-lookup?vin=7FARW2H82ME010827'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.
{
"type": "OK",
"answers": "SafetyNhtsaLookup@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"agency": "NHTSA"
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
},
"agency": "NHTSA"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}ratingsLookup
safety.ratingsLookup · GET /safeties/ratings-lookup · gate none · sandbox · answers SafetyRatingsLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.ratingsLookup({"vin":"7FARW2H82ME010827"})curl 'https://apis.vin/safeties/ratings-lookup?vin=7FARW2H82ME010827'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.
{
"type": "OK",
"answers": "SafetyRatingsLookup@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
}
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"ratings": {
"modelYear": 2024,
"bodyStyle": "sedan",
"overall": 3,
"frontal": 4,
"side": 4,
"rollover": 3,
"scale": "five-star",
"basis": "one-model-safety-card"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Apply & book
subscribe
safety.subscribe · POST /safeties/subscribe · gate offer · sandbox · answers SafetySubscribe@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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 — safety.vin serves this noun on its two routes: / (the landing) · /7FARW2H82ME010827 (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 — Safety.subscribed@1.
import { safety } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await safety.subscribe({"vin":"7FARW2H82ME010827"})curl -X POST https://apis.vin/safeties/subscribe \
-H 'content-type: application/json' \
-d '{"vin":"7FARW2H82ME010827"}'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.
{
"type": "OK",
"answers": "SafetySubscribe@1",
"value": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"subscription": {
"id": "ASB-1306aad4",
"topic": "safety-notices",
"status": "active"
}
},
"evidence": {
"vin": "7FARW2H82ME010827",
"noun": "safety",
"asOf": "2026-08-10",
"recordId": "VR-7f2a8473",
"facets": [
{
"facet": "title",
"value": "clean",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "odometer",
"value": "62893",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "ownership",
"value": "3-owners",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "accident",
"value": "none-reported",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "history-source"
},
{
"facet": "lien",
"value": "perfected",
"observedAt": "2026-08-10",
"confidence": "high",
"source": "title-registry"
},
{
"facet": "service",
"value": "3-visits-on-file",
"observedAt": "2026-08-10",
"confidence": "medium",
"source": "service-network"
}
],
"subscription": {
"id": "ASB-1306aad4",
"topic": "safety-notices",
"status": "active"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "record-annex-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.
VehicleRecord
Modeled
The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. One diagram, rendered from the estate model.
Safety · Class model
Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.