theft
The theft noun — identity, lifecycle, events, and every capability as an anchored section: 12 capabilities, 0 live, 12 sandbox, 0 declared.
theft 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 theft.vin · aggregator.vin.
Identity
| Noun | theft |
| Pillar | Data (facets: 6 data · 5 services · 1 commerce) |
| Capabilities | 12 — 0 live · 12 sandbox · 0 declared |
| Entities | VehicleRecord |
| Doors | aggregator.vin · theft.vin |
| SDK | Vin.theft.* from apis.vin |
| Address | /catalog/theft#{action} — the anchor IS the wire name minus theft. |
Events
The vocabulary this noun can append to the record — 7 past-tense, versioned event types, each linked to the capability that emits it:
Theft.cleared@1— emitted byclearTheft.feeCharged@1— emitted byfeeTheft.flagged@1— emitted byflagTheft.insurerRecoveryHandedOff@1— emitted byinsurerRecoveryHandoffTheft.personalPropertyInventoried@1— emitted bypersonalPropertyInventoryTheft.recoveryConditionReported@1— emitted byrecoveryConditionReportTheft.reported@1— emitted byreport
Discover & read
report
theft.report · POST /thefts/report · gate offer · sandbox · answers TheftReport@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 — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.reported@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.report({"vin":"3MZBPABM3SM468716"})curl -X POST https://apis.vin/thefts/report \
-H 'content-type: application/json' \
-d '{"vin":"3MZBPABM3SM468716"}'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": "TheftReport@1",
"value": {
"vin": "vin-61ff460f",
"asOf": "2027-05-07T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-61ff460f",
"asOf": "2027-05-07T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}recoveryLookup
theft.recoveryLookup · GET /thefts/recovery-lookup · gate none · sandbox · answers TheftRecoveryLookup@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.recoveryLookup({"vin":"3MZBPABM3SM468716"})curl 'https://apis.vin/thefts/recovery-lookup?vin=3MZBPABM3SM468716'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": "TheftRecoveryLookup@1",
"value": {
"vin": "vin-be6cf113",
"asOf": "2027-08-09T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-be6cf113",
"asOf": "2027-08-09T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}nicbCheck
theft.nicbCheck · GET /thefts/nicb-check · gate none · sandbox · answers TheftNicbCheck@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.nicbCheck({"vin":"3MZBPABM3SM468716"})curl 'https://apis.vin/thefts/nicb-check?vin=3MZBPABM3SM468716'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": "TheftNicbCheck@1",
"value": {
"vin": "vin-105aa800",
"asOf": "2027-02-12T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-105aa800",
"asOf": "2027-02-12T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}statusCheck
theft.statusCheck · GET /thefts/status-check · gate none · sandbox · answers TheftStatusCheck@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.statusCheck({"vin":"3MZBPABM3SM468716"})curl 'https://apis.vin/thefts/status-check?vin=3MZBPABM3SM468716'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": "TheftStatusCheck@1",
"value": {
"vin": "vin-4773c3e7",
"asOf": "2027-03-06T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-4773c3e7",
"asOf": "2027-03-06T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}telematicsLocate
theft.telematicsLocate · GET /thefts/telematics-locate · gate none · sandbox · answers TheftTelematicsLocate@1
No input — this capability takes no request body.
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.telematicsLocate()curl 'https://apis.vin/thefts/telematics-locate'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": "TheftTelematicsLocate@1",
"value": {
"vin": "vin-e099a5b4",
"asOf": "2027-03-19T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-e099a5b4",
"asOf": "2027-03-19T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}recoveryConditionReport
theft.recoveryConditionReport · POST /thefts/recovery-condition-report · gate key · sandbox · answers TheftRecoveryConditionReport@1
No input — this capability takes no request body.
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.recoveryConditionReported@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.recoveryConditionReport()curl -X POST https://apis.vin/thefts/recovery-condition-report \
-H 'content-type: application/json' \
-d '{}'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": "TheftRecoveryConditionReport@1",
"value": {
"vin": "vin-42537575",
"asOf": "2027-03-23T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-42537575",
"asOf": "2027-03-23T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Quote & price
fee
theft.fee · POST /thefts/fee · gate offer · sandbox · answers TheftFee@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 — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.feeCharged@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.fee({"vin":"3MZBPABM3SM468716"})curl -X POST https://apis.vin/thefts/fee \
-H 'content-type: application/json' \
-d '{"vin":"3MZBPABM3SM468716"}'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": "TheftFee@1",
"value": {
"vin": "vin-168d37a1",
"asOf": "2027-05-30T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-168d37a1",
"asOf": "2027-05-30T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Authorize & resolve
clear
theft.clear · POST /thefts/clear · gate offer · sandbox · answers TheftClear@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 — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.cleared@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.clear({"vin":"3MZBPABM3SM468716"})curl -X POST https://apis.vin/thefts/clear \
-H 'content-type: application/json' \
-d '{"vin":"3MZBPABM3SM468716"}'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": "TheftClear@1",
"value": {
"vin": "vin-452a18ec",
"asOf": "2027-03-08T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-452a18ec",
"asOf": "2027-03-08T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}flag
theft.flag · POST /thefts/flag · gate offer · sandbox · answers TheftFlag@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 — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.flagged@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.flag({"vin":"3MZBPABM3SM468716"})curl -X POST https://apis.vin/thefts/flag \
-H 'content-type: application/json' \
-d '{"vin":"3MZBPABM3SM468716"}'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": "TheftFlag@1",
"value": {
"vin": "vin-295eb542",
"asOf": "2026-11-04T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-295eb542",
"asOf": "2026-11-04T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}More actions
insurerRecoveryHandoff
theft.insurerRecoveryHandoff · POST /thefts/insurer-recovery-handoff · gate key · sandbox · answers TheftInsurerRecoveryHandoff@1
No input — this capability takes no request body.
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.insurerRecoveryHandedOff@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.insurerRecoveryHandoff()curl -X POST https://apis.vin/thefts/insurer-recovery-handoff \
-H 'content-type: application/json' \
-d '{}'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": "TheftInsurerRecoveryHandoff@1",
"value": {
"vin": "vin-793ba8c2",
"asOf": "2027-04-28T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-793ba8c2",
"asOf": "2027-04-28T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}lprHit
theft.lprHit · GET /thefts/lpr-hit · gate none · sandbox · answers TheftLprHit@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — theft.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.lprHit({"vin":"3MZBPABM3SM468716"})curl 'https://apis.vin/thefts/lpr-hit?vin=3MZBPABM3SM468716'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": "TheftLprHit@1",
"value": {
"vin": "vin-6789d9f7",
"asOf": "2027-05-16T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-6789d9f7",
"asOf": "2027-05-16T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}personalPropertyInventory
theft.personalPropertyInventory · POST /thefts/personal-property-inventory · gate key · sandbox · answers TheftPersonalPropertyInventory@1
No input — this capability takes no request body.
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3MZBPABM3SM468716 (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 — Theft.personalPropertyInventoried@1.
import { theft } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await theft.personalPropertyInventory()curl -X POST https://apis.vin/thefts/personal-property-inventory \
-H 'content-type: application/json' \
-d '{}'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": "TheftPersonalPropertyInventory@1",
"value": {
"vin": "vin-b656c058",
"asOf": "2027-02-10T00:00:00.000Z",
"facets": []
},
"evidence": {
"vin": "vin-b656c058",
"asOf": "2027-02-10T00:00:00.000Z",
"facets": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "theft-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
Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.