docs.vin

ro

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

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

Identity

Nounro
PillarServices (facets: 5 data · 9 services · 8 commerce)
Capabilities22 — 0 live · 22 sandbox · 0 declared
EntitiesRepairOrder
Doorsaggregator.vin · fixedops.vin
SDKVin.ro.* from apis.vin
Address/catalog/ro#{action} — the anchor IS the wire name minus ro.

Events

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

Discover & read

read

ro.read · GET /ros/read · gate none · sandbox · answers RoRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.read({"vin":"1N6ED1EK2SN608115"})
GET /ros/read
curl 'https://apis.vin/ros/read?vin=1N6ED1EK2SN608115'

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:16.805Z · HTTP 200
{
  "type": "OK",
  "answers": "RoRead@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

history

ro.history · GET /ros/history · gate none · sandbox · answers RoHistory@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.history({"vin":"1N6ED1EK2SN608115"})
GET /ros/history
curl 'https://apis.vin/ros/history?vin=1N6ED1EK2SN608115'

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:16.797Z · HTTP 200
{
  "type": "OK",
  "answers": "RoHistory@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "events": [
      {
        "date": "2024-03-14",
        "kind": "routine",
        "description": "routine repair order record"
      }
    ]
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "events": [
      {
        "date": "2024-03-14",
        "kind": "routine",
        "description": "routine repair order record"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

status

ro.status · GET /ros/status · gate none · sandbox · answers RoStatus@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.status({"vin":"1N6ED1EK2SN608115"})
GET /ros/status
curl 'https://apis.vin/ros/status?vin=1N6ED1EK2SN608115'

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:16.826Z · HTTP 200
{
  "type": "OK",
  "answers": "RoStatus@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

ro.quote · POST /ros/quote · gate offer · sandbox · answers RoQuote@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) · /1N6ED1EK2SN608115 (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 — Ro.quoteRequested@1 · Ro.quoted@1.

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

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

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:16.805Z · HTTP 200
{
  "type": "OK",
  "answers": "RoQuote@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "estimate": {
      "id": "EST-d58237f3",
      "stance": "PartiallyApproved",
      "amountCents": 59000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "estimate": {
      "id": "EST-d58237f3",
      "stance": "PartiallyApproved",
      "amountCents": 59000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

estimate

ro.estimate · POST /ros/estimate · gate offer · sandbox · answers RoEstimate@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) · /1N6ED1EK2SN608115 (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 — Ro.estimateRequested@1 · Ro.estimated@1.

the SDK — ro.estimate
import { ro } from 'apis.vin'

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

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:16.778Z · HTTP 200
{
  "type": "OK",
  "answers": "RoEstimate@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "estimate": {
      "id": "EST-630c8583",
      "stance": "PartiallyApproved",
      "amountCents": 59000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "estimate": {
      "id": "EST-630c8583",
      "stance": "PartiallyApproved",
      "amountCents": 59000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

open

ro.open · POST /ros/open · gate offer · sandbox · answers RoOpen@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) · /1N6ED1EK2SN608115 (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 — Ro.openRequested@1 · Ro.opened@1.

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

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

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:16.802Z · HTTP 200
{
  "type": "OK",
  "answers": "RoOpen@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "status": "open"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "status": "open"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

dispatch

ro.dispatch · POST /ros/dispatch · gate offer · sandbox · answers RoDispatch@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) · /1N6ED1EK2SN608115 (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 — Ro.dispatchFailed@1 · Ro.dispatchRequested@1 · Ro.dispatched@1.

the SDK — ro.dispatch
import { ro } from 'apis.vin'

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

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:16.778Z · HTTP 200
{
  "type": "OK",
  "answers": "RoDispatch@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "dispatch": {
      "bay": "BAY-4",
      "status": "dispatched"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "dispatch": {
      "bay": "BAY-4",
      "status": "dispatched"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

warrantySubmit

ro.warrantySubmit · POST /ros/warranty-submit · gate offer · sandbox · answers RoWarrantySubmit@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) · /1N6ED1EK2SN608115 (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 — Ro.warrantySubmitFailed@1 · Ro.warrantySubmitRequested@1 · Ro.warrantySubmitted@1.

the SDK — ro.warrantySubmit
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.warrantySubmit({"vin":"1N6ED1EK2SN608115"})
POST /ros/warranty-submit
curl -X POST https://apis.vin/ros/warranty-submit \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115"}'

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:16.845Z · HTTP 200
{
  "type": "OK",
  "answers": "RoWarrantySubmit@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "submit": {
      "status": "submitted",
      "claimId": "WCL-a0dc6a59"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "submit": {
      "status": "submitted",
      "claimId": "WCL-a0dc6a59"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

repairOrder

ro.repairOrder · POST /ros/repair-order · gate offer · sandbox · answers ServiceRepairOrder@1

FieldTypeRequiredNotes
vinstringyes—
appointmentIdstringno—
linesarray<object>yesmulti-line RO: opCode, CP/warranty/internal, tech, parts
loanerbooleanno—
authoritystringno—

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.

Delegated calls require a typed Mandate — { ceiling, perAction, expires, tripwires }; the ceiling is a field, not a conversation.

Door — fixedops.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK2SN608115 (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 — Appointment.scheduled@1 · RepairOrder.closed@1 · RepairOrder.lineAdded@1 · RepairOrder.opened@1 · ServiceOrder.settled@1.

the SDK — ro.repairOrder
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.repairOrder({"vin":"1N6ED1EK2SN608115","lines":[]})
POST /ros/repair-order
curl -X POST https://apis.vin/ros/repair-order \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115","lines":[]}'

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:16.810Z · HTTP 200
{
  "type": "OK",
  "answers": "ServiceRepairOrder@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "laborRateCentsPerHour": 16500,
    "lineCount": 1,
    "totalCents": 59000,
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

ro.pay · POST /ros/pay · gate offer · sandbox · answers RoPay@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) · /1N6ED1EK2SN608115 (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 — Ro.paid@1 · Ro.payFailed@1 · Ro.payRequested@1.

the SDK — ro.pay
import { ro } from 'apis.vin'

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

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:16.803Z · HTTP 200
{
  "type": "OK",
  "answers": "RoPay@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "payment": {
      "id": "PAY-d73b0eb5",
      "status": "settled",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "payment": {
      "id": "PAY-d73b0eb5",
      "status": "settled",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

invoice

ro.invoice · POST /ros/invoice · gate offer · sandbox · answers RoInvoice@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) · /1N6ED1EK2SN608115 (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 — Ro.invoiceFailed@1 · Ro.invoiceRequested@1 · Ro.invoiced@1.

the SDK — ro.invoice
import { ro } from 'apis.vin'

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

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:16.802Z · HTTP 200
{
  "type": "OK",
  "answers": "RoInvoice@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "invoice": {
      "id": "INV-6cd0302c",
      "status": "pending-completion",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "invoice": {
      "id": "INV-6cd0302c",
      "status": "pending-completion",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

settle

ro.settle · POST /ros/settle · gate offer · sandbox · answers RoSettle@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) · /1N6ED1EK2SN608115 (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 — Ro.settleFailed@1 · Ro.settleRequested@1 · Ro.settled@1.

the SDK — ro.settle
import { ro } from 'apis.vin'

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

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:16.815Z · HTTP 200
{
  "type": "OK",
  "answers": "RoSettle@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "payment": {
      "id": "PAY-9b9fec26",
      "status": "settled",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "payment": {
      "id": "PAY-9b9fec26",
      "status": "settled",
      "amountCents": 59000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

splitPay

ro.splitPay · POST /ros/split-pay · gate offer · sandbox · answers RoSplitPay@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) · /1N6ED1EK2SN608115 (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 — Ro.splitPaid@1 · Ro.splitPayFailed@1 · Ro.splitPayRequested@1.

the SDK — ro.splitPay
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.splitPay({"vin":"1N6ED1EK2SN608115"})
POST /ros/split-pay
curl -X POST https://apis.vin/ros/split-pay \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115"}'

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:16.820Z · HTTP 200
{
  "type": "OK",
  "answers": "RoSplitPay@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "split": {
      "parts": [
        {
          "party": "customer",
          "amountCents": 29500
        },
        {
          "party": "warranty",
          "amountCents": 29500
        }
      ],
      "currency": "USD",
      "status": "settled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "split": {
      "parts": [
        {
          "party": "customer",
          "amountCents": 29500
        },
        {
          "party": "warranty",
          "amountCents": 29500
        }
      ],
      "currency": "USD",
      "status": "settled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

internalBill

ro.internalBill · POST /ros/internal-bill · gate offer · sandbox · answers RoInternalBill@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) · /1N6ED1EK2SN608115 (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 — Ro.internalBillRequested@1 · Ro.internalBilled@1.

the SDK — ro.internalBill
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.internalBill({"vin":"1N6ED1EK2SN608115"})
POST /ros/internal-bill
curl -X POST https://apis.vin/ros/internal-bill \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115"}'

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:16.802Z · HTTP 200
{
  "type": "OK",
  "answers": "RoInternalBill@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "bill": {
      "id": "IB-4b1530cc",
      "kind": "internal",
      "amountCents": 59000,
      "currency": "USD",
      "status": "issued"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "bill": {
      "id": "IB-4b1530cc",
      "kind": "internal",
      "amountCents": 59000,
      "currency": "USD",
      "status": "issued"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

update

ro.update · POST /ros/update · gate offer · sandbox · answers RoUpdate@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) · /1N6ED1EK2SN608115 (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 — Ro.updateRequested@1 · Ro.updated@1.

the SDK — ro.update
import { ro } from 'apis.vin'

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

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:16.831Z · HTTP 200
{
  "type": "OK",
  "answers": "RoUpdate@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "line": {
      "line": 2,
      "kind": "labor",
      "amountCents": 16500,
      "currency": "USD"
    },
    "status": "recorded"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "line": {
      "line": 2,
      "kind": "labor",
      "amountCents": 16500,
      "currency": "USD"
    },
    "status": "recorded"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

split

ro.split · POST /ros/split · gate offer · sandbox · answers RoSplit@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) · /1N6ED1EK2SN608115 (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 — Ro.split@1 · Ro.splitRequested@1.

the SDK — ro.split
import { ro } from 'apis.vin'

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

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:16.818Z · HTTP 200
{
  "type": "OK",
  "answers": "RoSplit@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "split": {
      "parts": [
        {
          "party": "customer",
          "amountCents": 29500
        },
        {
          "party": "warranty",
          "amountCents": 29500
        }
      ],
      "currency": "USD",
      "status": "proposed"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "split": {
      "parts": [
        {
          "party": "customer",
          "amountCents": 29500
        },
        {
          "party": "warranty",
          "amountCents": 29500
        }
      ],
      "currency": "USD",
      "status": "proposed"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

flagComplete

ro.flagComplete · POST /ros/flag-complete · gate offer · sandbox · answers RoFlagComplete@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) · /1N6ED1EK2SN608115 (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 — Ro.flagCompleteRequested@1 · Ro.flaggedCompleted@1.

the SDK — ro.flagComplete
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.flagComplete({"vin":"1N6ED1EK2SN608115"})
POST /ros/flag-complete
curl -X POST https://apis.vin/ros/flag-complete \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115"}'

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:16.784Z · HTTP 200
{
  "type": "OK",
  "answers": "RoFlagComplete@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "flag": "in-process"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "flag": "in-process"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Lifecycle & state

reopen

ro.reopen · POST /ros/reopen · gate offer · sandbox · answers RoReopen@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) · /1N6ED1EK2SN608115 (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 — Ro.reopenRequested@1 · Ro.reopened@1.

the SDK — ro.reopen
import { ro } from 'apis.vin'

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

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:16.810Z · HTTP 200
{
  "type": "OK",
  "answers": "RoReopen@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "reopen": {
      "status": "not-closed"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "reopen": {
      "status": "not-closed"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

close

ro.close · POST /ros/close · gate offer · sandbox · answers RoClose@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) · /1N6ED1EK2SN608115 (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 — Ro.closeRequested@1 · Ro.closed@1.

the SDK — ro.close
import { ro } from 'apis.vin'

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

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:16.778Z · HTTP 200
{
  "type": "OK",
  "answers": "RoClose@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "close": {
      "status": "blocked-open-work"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "close": {
      "status": "blocked-open-work"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

addLine

ro.addLine · POST /ros/add-line · gate offer · sandbox · answers RoAddLine@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) · /1N6ED1EK2SN608115 (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 — Ro.addLineRequested@1 · Ro.lineAdded@1.

the SDK — ro.addLine
import { ro } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.addLine({"vin":"1N6ED1EK2SN608115"})
POST /ros/add-line
curl -X POST https://apis.vin/ros/add-line \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK2SN608115"}'

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:16.768Z · HTTP 200
{
  "type": "OK",
  "answers": "RoAddLine@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "line": {
      "line": 2,
      "kind": "labor",
      "amountCents": 16500,
      "currency": "USD"
    },
    "status": "recorded"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "line": {
      "line": 2,
      "kind": "labor",
      "amountCents": 16500,
      "currency": "USD"
    },
    "status": "recorded"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

aging

ro.aging · GET /ros/aging · gate none · sandbox · answers RoAging@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.aging({"vin":"1N6ED1EK2SN608115"})
GET /ros/aging
curl 'https://apis.vin/ros/aging?vin=1N6ED1EK2SN608115'

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:16.768Z · HTTP 200
{
  "type": "OK",
  "answers": "RoAging@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "days": 8
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "days": 8
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

lineItems

ro.lineItems · GET /ros/line-items · gate none · sandbox · answers RoLineItems@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ro.lineItems({"vin":"1N6ED1EK2SN608115"})
GET /ros/line-items
curl 'https://apis.vin/ros/line-items?vin=1N6ED1EK2SN608115'

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:16.802Z · HTTP 200
{
  "type": "OK",
  "answers": "RoLineItems@1",
  "value": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "lines": [
      {
        "line": 1,
        "kind": "labor",
        "description": "labor operation",
        "amountCents": 16500
      }
    ],
    "totalCents": 59000,
    "currency": "USD"
  },
  "evidence": {
    "vin": "1N6ED1EK2SN608115",
    "noun": "ro",
    "asOf": "2026-08-10",
    "roId": "RO-3eb8d90c",
    "position": "EstimateApproval",
    "lines": [
      {
        "line": 1,
        "kind": "labor",
        "description": "labor operation",
        "amountCents": 16500
      }
    ],
    "totalCents": 59000,
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "shop-arc-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.

RepairOrder

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

review

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

roadside

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

On this page

Identity
Events
Discover & read
read
history
status
Quote & price
quote
estimate
Apply & book
open
dispatch
warrantySubmit
repairOrder
Pay & settle
pay
invoice
settle
splitPay
internalBill
Fulfill & operate
update
split
flagComplete
Lifecycle & state
reopen
close
More actions
addLine
aging
lineItems
Data model
RepairOrder