docs.vin

fraudCase

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

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

Identity

NounfraudCase
PillarData (facets: 7 data · 2 services)
Capabilities9 — 0 live · 9 sandbox · 0 declared
EntitiesParty
Doorsaggregator.vin
SDKVin.fraudCase.* from apis.vin
Address/catalog/fraudCase#{action} — the anchor IS the wire name minus fraudCase.

Events

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

Discover & read

suspiciousActivityReport

fraudCase.suspiciousActivityReport · POST /fraud-cases/suspicious-activity-report · gate key · sandbox · answers FraudCaseSuspiciousActivityReport@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.suspiciousActivityReported@1.

the SDK — fraudCase.suspiciousActivityReport
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.suspiciousActivityReport()
POST /fraud-cases/suspicious-activity-report
curl -X POST https://apis.vin/fraud-cases/suspicious-activity-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.

receipt · executed 2026-08-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseSuspiciousActivityReport@1",
  "value": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "report": {
      "status": "nothing-to-report",
      "basis": "no-fraud-signal-on-file",
      "identityId": "ID-11f17424"
    }
  },
  "evidence": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "report": {
      "status": "nothing-to-report",
      "basis": "no-fraud-signal-on-file",
      "identityId": "ID-11f17424"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

curbstoneDetect

fraudCase.curbstoneDetect · GET /fraud-cases/curbstone-detect · gate none · sandbox · answers FraudCaseCurbstoneDetect@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.curbstoneDetected@1.

the SDK — fraudCase.curbstoneDetect
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.curbstoneDetect()
GET /fraud-cases/curbstone-detect
curl 'https://apis.vin/fraud-cases/curbstone-detect'

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-16T14:50:09.839Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseCurbstoneDetect@1",
  "value": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "curbstone": {
      "suspected": false,
      "seller": {
        "id": "DLR-b9066ade",
        "name": "The Estate Store",
        "licenseId": "DL-7bcdd2ef"
      },
      "basis": "licensed-dealer-of-record"
    }
  },
  "evidence": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "curbstone": {
      "suspected": false,
      "seller": {
        "id": "DLR-b9066ade",
        "name": "The Estate Store",
        "licenseId": "DL-7bcdd2ef"
      },
      "basis": "licensed-dealer-of-record"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

floorplanDoubleFinanceDetect

fraudCase.floorplanDoubleFinanceDetect · GET /fraud-cases/floorplan-double-finance-detect · gate none · sandbox · answers FraudCaseFloorplanDoubleFinanceDetect@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.floorplanDoubleFinanceDetected@1.

the SDK — fraudCase.floorplanDoubleFinanceDetect
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.floorplanDoubleFinanceDetect()
GET /fraud-cases/floorplan-double-finance-detect
curl 'https://apis.vin/fraud-cases/floorplan-double-finance-detect'

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-16T14:50:09.839Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseFloorplanDoubleFinanceDetect@1",
  "value": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "doubleFinance": {
      "suspected": false,
      "line": {
        "kind": "floorplan",
        "limitCents": 10000000,
        "usedCents": 2375000,
        "currency": "USD"
      },
      "basis": "one-floorplan-line"
    }
  },
  "evidence": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "doubleFinance": {
      "suspected": false,
      "line": {
        "kind": "floorplan",
        "limitCents": 10000000,
        "usedCents": 2375000,
        "currency": "USD"
      },
      "basis": "one-floorplan-line"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

powerBookingDetect

fraudCase.powerBookingDetect · GET /fraud-cases/power-booking-detect · gate none · sandbox · answers FraudCasePowerBookingDetect@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.powerBookingDetected@1.

the SDK — fraudCase.powerBookingDetect
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.powerBookingDetect()
GET /fraud-cases/power-booking-detect
curl 'https://apis.vin/fraud-cases/power-booking-detect'

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-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCasePowerBookingDetect@1",
  "value": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "powerBooking": {
      "suspected": false,
      "bookCents": 499500,
      "contractCents": 499500,
      "varianceCents": 0,
      "currency": "USD",
      "basis": "one-asking-value"
    }
  },
  "evidence": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "powerBooking": {
      "suspected": false,
      "bookCents": 499500,
      "contractCents": 499500,
      "varianceCents": 0,
      "currency": "USD",
      "basis": "one-asking-value"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

strawBuyerDetect

fraudCase.strawBuyerDetect · GET /fraud-cases/straw-buyer-detect · gate none · sandbox · answers FraudCaseStrawBuyerDetect@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.strawBuyerDetected@1.

the SDK — fraudCase.strawBuyerDetect
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.strawBuyerDetect()
GET /fraud-cases/straw-buyer-detect
curl 'https://apis.vin/fraud-cases/straw-buyer-detect'

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-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseStrawBuyerDetect@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "detectionRef": "STRAW-001O",
    "strawBuyerSuspected": false,
    "indicators": [],
    "riskScore": 12,
    "recommendedAction": "clear",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "detectionRef": "STRAW-001O",
    "strawBuyerSuspected": false,
    "indicators": [],
    "riskScore": 12,
    "recommendedAction": "clear",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "fraud-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

syntheticIdentityDetect

fraudCase.syntheticIdentityDetect · GET /fraud-cases/synthetic-identity-detect · gate none · sandbox · answers FraudCaseSyntheticIdentityDetect@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.syntheticIdentityDetected@1.

the SDK — fraudCase.syntheticIdentityDetect
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.syntheticIdentityDetect()
GET /fraud-cases/synthetic-identity-detect
curl 'https://apis.vin/fraud-cases/synthetic-identity-detect'

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-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseSyntheticIdentityDetect@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "caseRef": "SYN-001O",
    "syntheticIdentitySuspected": false,
    "riskScore": 12,
    "riskBand": "low",
    "indicators": [],
    "recommendedAction": "proceed",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "caseRef": "SYN-001O",
    "syntheticIdentitySuspected": false,
    "riskScore": 12,
    "riskBand": "low",
    "indicators": [],
    "recommendedAction": "proceed",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "fraud-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

open

fraudCase.open · POST /fraud-cases/open · gate key · sandbox · answers FraudCaseOpen@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.opened@1.

the SDK — fraudCase.open
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.open()
POST /fraud-cases/open
curl -X POST https://apis.vin/fraud-cases/open \
  -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.

receipt · executed 2026-08-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseOpen@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "caseRef": "FRD-001O",
    "caseType": "suspicious-activity",
    "status": "open",
    "priority": "standard",
    "indicatorsPresent": false,
    "assignedQueue": "sandbox-review",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "caseRef": "FRD-001O",
    "caseType": "suspicious-activity",
    "status": "open",
    "priority": "standard",
    "indicatorsPresent": false,
    "assignedQueue": "sandbox-review",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "fraud-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

stagedAccidentFlag

fraudCase.stagedAccidentFlag · GET /fraud-cases/staged-accident-flag · gate none · sandbox · answers FraudCaseStagedAccidentFlag@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.stagedAccidentFlagged@1.

the SDK — fraudCase.stagedAccidentFlag
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.stagedAccidentFlag()
GET /fraud-cases/staged-accident-flag
curl 'https://apis.vin/fraud-cases/staged-accident-flag'

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-16T14:50:09.840Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseStagedAccidentFlag@1",
  "value": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "stagedAccident": {
      "flagged": false,
      "status": "no-accident-on-file"
    }
  },
  "evidence": {
    "partyId": "ID-11f17424",
    "type": "person",
    "name": "Ava Good",
    "identifiers": [
      {
        "kind": "cast-key",
        "value": "ava-good"
      }
    ],
    "roles": [
      {
        "role": "customer"
      }
    ],
    "status": "active",
    "vin": "1HGCM82633A004352",
    "noun": "fraudCase",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "stagedAccident": {
      "flagged": false,
      "status": "no-accident-on-file"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

identityTheftVictimResolve

fraudCase.identityTheftVictimResolve · POST /fraud-cases/identity-theft-victim-resolve · gate key · sandbox · answers FraudCaseIdentityTheftVictimResolve@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1FA6P8CF0J5107757 (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.

EmitsFraudCase.identityTheftVictimResolved@1.

the SDK — fraudCase.identityTheftVictimResolve
import { fraudCase } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fraudCase.identityTheftVictimResolve()
POST /fraud-cases/identity-theft-victim-resolve
curl -X POST https://apis.vin/fraud-cases/identity-theft-victim-resolve \
  -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.

receipt · executed 2026-08-16T14:50:09.839Z · HTTP 200
{
  "type": "OK",
  "answers": "FraudCaseIdentityTheftVictimResolve@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "caseRef": "ITV-001O",
    "victimClaimAccepted": true,
    "disputedTradelineFlagged": true,
    "accountBlockedFromCollections": true,
    "remediationSteps": [
      "fraud-affidavit-filed",
      "tradeline-suppressed",
      "title-hold-placed"
    ],
    "resolutionState": "victim-remediation-open",
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "caseRef": "ITV-001O",
    "victimClaimAccepted": true,
    "disputedTradelineFlagged": true,
    "accountBlockedFromCollections": true,
    "remediationSteps": [
      "fraud-affidavit-filed",
      "tradeline-suppressed",
      "title-hold-placed"
    ],
    "resolutionState": "victim-remediation-open",
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "fraud-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.

Party

Modeled

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

FraudCase · Class model

FraudCase · Class model

FraudCase · State machine

FraudCase · Sequence


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