docs.vin

guardianship

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

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

Identity

Nounguardianship
PillarServices (facets: 1 data · 2 services)
Capabilities3 — 0 live · 3 sandbox · 0 declared
EntitiesParty
Doorsaggregator.vin
SDKVin.guardianship.* from apis.vin
Address/catalog/guardianship#{action} — the anchor IS the wire name minus guardianship.

Events

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

Discover & read

courtAuthorityVerify

guardianship.courtAuthorityVerify · GET /guardianships/court-authority-verify · gate none · sandbox · answers GuardianshipCourtAuthorityVerify@1

No input — this capability takes no request body.

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

EmitsGuardianship.courtAuthorityVerified@1.

the SDK — guardianship.courtAuthorityVerify
import { guardianship } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await guardianship.courtAuthorityVerify()
GET /guardianships/court-authority-verify
curl 'https://apis.vin/guardianships/court-authority-verify'

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.855Z · HTTP 200
{
  "type": "OK",
  "answers": "GuardianshipCourtAuthorityVerify@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "verificationRef": "GRD-001O",
    "guardianName": "SANDBOX, PAT",
    "wardName": "SANDBOX, ALEX",
    "instrument": "letters-of-guardianship",
    "authorityVerified": true,
    "scopeIncludesVehicleTransactions": true,
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "verificationRef": "GRD-001O",
    "guardianName": "SANDBOX, PAT",
    "wardName": "SANDBOX, ALEX",
    "instrument": "letters-of-guardianship",
    "authorityVerified": true,
    "scopeIncludesVehicleTransactions": true,
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "legal-authority-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

conservatorSign

guardianship.conservatorSign · POST /guardianships/conservator-sign · gate key · sandbox · answers GuardianshipConservatorSign@1

No input — this capability takes no request body.

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

EmitsGuardianship.conservatorSigned@1.

the SDK — guardianship.conservatorSign
import { guardianship } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await guardianship.conservatorSign()
POST /guardianships/conservator-sign
curl -X POST https://apis.vin/guardianships/conservator-sign \
  -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.855Z · HTTP 200
{
  "type": "OK",
  "answers": "GuardianshipConservatorSign@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "signingRef": "GCS-001O",
    "conservatorName": "SANDBOX, PAT",
    "wardName": "SANDBOX, ALEX",
    "instrument": "letters-of-conservatorship",
    "authorityVerified": true,
    "scopeIncludesVehicleTransactions": true,
    "signatureAccepted": true,
    "asOf": "2026-08-10"
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "signingRef": "GCS-001O",
    "conservatorName": "SANDBOX, PAT",
    "wardName": "SANDBOX, ALEX",
    "instrument": "letters-of-conservatorship",
    "authorityVerified": true,
    "scopeIncludesVehicleTransactions": true,
    "signatureAccepted": true,
    "asOf": "2026-08-10"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "legal-authority-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

minorCoBuyer

guardianship.minorCoBuyer · POST /guardianships/minor-co-buyer · gate key · sandbox · answers GuardianshipMinorCoBuyer@1

No input — this capability takes no request body.

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

EmitsGuardianship.minorCoBuyerApproved@1.

the SDK — guardianship.minorCoBuyer
import { guardianship } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await guardianship.minorCoBuyer()
POST /guardianships/minor-co-buyer
curl -X POST https://apis.vin/guardianships/minor-co-buyer \
  -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.855Z · HTTP 200
{
  "type": "OK",
  "answers": "GuardianshipMinorCoBuyer@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": "guardianship",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "minorCoBuyer": {
      "status": "no-minor-on-file",
      "basis": "cast-of-adults",
      "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": "guardianship",
    "asOf": "2026-08-10",
    "identityId": "ID-11f17424",
    "minorCoBuyer": {
      "status": "no-minor-on-file",
      "basis": "cast-of-adults",
      "identityId": "ID-11f17424"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "watch-desk-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. One diagram, rendered from the estate model.

Guardianship · 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.