Skip to content
AutomotiveMCP
SchemasCore objects · C0RFC / v0.1

Document

v0.1.0

A document or artifact produced or consumed during a dealership transaction — a purchase agreement, retail installment contract, lease agreement, credit application printout, consent form, signed PDF, title, or e-signature envelope. Captures the file's identity, lifecycle status, what business object it belongs to, retrieval location, integrity, retention posture, and any signatures collected against it. ADF never modeled documents; this fills that gap and maps to the spec's core Document domain. SENSITIVE: a document may embody PII (SSN fragments, DOB, driver's license, financial terms) inside the referenced file; the is_pii / pii_categories flags and signature ip_address / signer_email / signer_phone / signer_name carry x-pii and MUST be handled under the spec's Auth & Security profile.

Resourcescore.get_documentcore.list_documents

document.example.jsonJSON
{
  "id": "9f8b2c14-3d5e-4a6f-8b1c-2e3f4a5b6c7d",
  "source_ids": [
    {
      "system": "dealertrack_dms",
      "id": "DOC-88213",
      "sequence": 1
    },
    {
      "system": "docusign",
      "id": "envelope_2b7c9d0e-1f23-4567-89ab-cdef01234567",
      "sequence": 2
    }
  ],
  "type": "retail_installment",
  "name": "Retail Installment Sale Contract — Stock #A1042",
  "description": "Executed RISC for the Rivera purchase; supersedes the initial mis-keyed contract.",
  "status": "signed",
  "related_to": [
    {
      "type": "deal",
      "id": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
    },
    {
      "type": "customer",
      "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70"
    }
  ],
  "url": "https://docs.example-dms.com/documents/9f8b2c14/download?token=abc123",
  "mime_type": "application/pdf",
  "size_bytes": 284517,
  "page_count": 6,
  "language": "en-US",
  "checksum": {
    "algorithm": "sha256",
    "value": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  },
  "version": 2,
  "supersedes_document_id": "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
  "template_id": "553-CA-ARB-0324",
  "signature_status": {
    "required_count": 3,
    "completed_count": 3
  },
  "signatures": [
    {
      "signer_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "signer_name": {
        "full": "Jordan A. Rivera"
      },
      "signer_email": {
        "address": "jordan.rivera@example.com"
      },
      "role": "buyer",
      "method": "electronic",
      "signer_status": "signed",
      "signed_at": "2026-06-28T15:42:10Z",
      "ip_address": "203.0.113.42",
      "consent_disclosure_accepted": true
    },
    {
      "signer_id": "b2c3d4e5-f6a7-4b9c-8d1e-2f3a4b5c6d7e",
      "signer_name": {
        "full": "Morgan L. Rivera"
      },
      "signer_phone": {
        "number": "+1 415 555 0199"
      },
      "role": "co_buyer",
      "method": "electronic",
      "signer_status": "signed",
      "signed_at": "2026-06-28T15:47:55Z",
      "ip_address_v6": "2001:db8:85a3::8a2e:370:7334",
      "consent_disclosure_accepted": true
    },
    {
      "signer_id": "c3d4e5f6-a7b8-4c0d-9e2f-3a4b5c6d7e8f",
      "signer_name": {
        "full": "Taylor Finance Mgr"
      },
      "role": "dealer",
      "method": "electronic",
      "signer_status": "signed",
      "signed_at": "2026-06-28T15:50:03Z",
      "ip_address": "198.51.100.7"
    }
  ],
  "is_pii": true,
  "pii_categories": [
    "ssn_fragment",
    "financial_account",
    "signature_image"
  ],
  "retention": {
    "policy": "fni-7yr",
    "delete_after": "2033-06-28",
    "legal_hold": false
  },
  "signed_at": "2026-06-28T15:50:03Z",
  "generated_at": "2026-06-28T15:30:00Z",
  "expires_at": "2026-07-05T23:59:59Z",
  "created_at": "2026-06-28T15:30:05Z",
  "updated_at": "2026-06-28T15:50:04Z",
  "extensions": {
    "docusign:envelope_status": "completed",
    "dealertrack:doc_stack_id": "STK-77120"
  }
}
Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.