SchemasService · R04RFC / v0.1

Warranty Claim

v0.1.0

A warranty or service-contract claim submitted by a dealer's service department against an OEM factory warranty, a powertrain warranty, an extended service contract (ESC/VSC) administrator, a goodwill authorization, a safety recall, or a technical service bulletin (TSB). Captures the failed operation, the repair performed (labor operations, parts, and hours), the complaint/cause/correction narrative, the amounts requested and approved, chargeback/rejection detail, and the full submitted/decisioned/paid lifecycle. Sits downstream of a Service Order (repair order): the RO documents the physical work, the Warranty Claim is the reimbursement request filed against a payer. Extends ADF/STAR AutomotiveAPI warranty-claim messaging into a typed, line-itemized JSON record so AI agents can read claim status and submit new claims through a dealer's DMS or a third-party warranty-administration platform.

Resourcesservice.get_warranty_claimservice.submit_warranty_claim

warranty-claim.example.jsonJSON

{
  "id": "a3f1c9d2-7b4e-4c81-9f26-5d0a1e8b3c47",
  "source_ids": [
    {
      "system": "dms",
      "id": "WC-778201",
      "sequence": 1
    },
    {
      "system": "oem_warranty_portal",
      "id": "GM-CLM-4471902",
      "sequence": 2
    }
  ],
  "claim_number": "GM-CLM-4471902",
  "type": "powertrain",
  "status": "partially_approved",
  "service_order_id": "b21f9d4e-6c8a-4f13-9e77-3a1c2d5b6f80",
  "vehicle_id": "7c3e0b2a-1f4d-4e9a-9b21-2a5e8f0c9d34",
  "customer_id": "9f2a7c11-4d3e-4b8a-8c56-1e0f9a2b3c4d",
  "vin": "1GNSKBKC5FR298187",
  "mileage": 48720,
  "mileage_unit": "miles",
  "in_service_date": "2022-03-14",
  "sale_date": "2022-03-14",
  "dealer": {
    "dealer_code": "112233",
    "name": "Lakeside Chevrolet",
    "service_labor_rate": {
      "amount": 120,
      "currency": "USD"
    },
    "parts_markup": 40,
    "address": {
      "city": "Cleveland",
      "region": "OH",
      "postal_code": "44102",
      "lines": [
        "4400 Lakeshore Blvd"
      ],
      "country": "US"
    },
    "phone_number": {
      "number": "+1 216-555-0142"
    }
  },
  "oem": {
    "brand": "Chevrolet",
    "warranty_code": "PT-05"
  },
  "authorization": {
    "prior_authorization_number": "PA-88213",
    "authorized_by": {
      "first": "Dana",
      "last": "Okoro"
    },
    "authorized_at": "2026-06-23T16:40:00-07:00",
    "authorized_amount": {
      "amount": 1500,
      "currency": "USD"
    }
  },
  "failure": {
    "code": "P0700",
    "description": "Transmission control system malfunction; harsh 2-3 shift and stored TCM fault",
    "date": "2026-06-22",
    "complaint": "Customer states harsh shift between 2nd and 3rd and intermittent check-engine light.",
    "cause": "Internal valve body solenoid stuck, setting P0700 and commanding failsafe shift pressure.",
    "correction": "Replaced transmission control valve body assembly, relearned adaptives, road-tested; no codes on retest.",
    "causal_part_number": "24299921"
  },
  "coverage": {
    "deductible_type": "per_visit",
    "coverage_expires_date": "2027-03-14",
    "coverage_expires_mileage": 60000
  },
  "technician": {
    "technician_id": "T-2091",
    "name": {
      "first": "Marcus",
      "last": "Reyes"
    },
    "certification_level": "GM World Class Technician"
  },
  "repair": {
    "op_codes": [
      "T3520",
      "T3610"
    ],
    "repair_completed_at": "2026-06-24T13:10:00-07:00",
    "labor_operations": [
      {
        "op_code": "T3520",
        "description": "R&R transmission valve body",
        "labor_hours": 4,
        "labor_amount": {
          "amount": 480,
          "currency": "USD"
        }
      },
      {
        "op_code": "T3610",
        "description": "Transmission adaptive relearn and road test",
        "labor_hours": 0.6,
        "labor_amount": {
          "amount": 72,
          "currency": "USD"
        }
      }
    ],
    "parts": [
      {
        "part_number": "24299921",
        "description": "Transmission control valve body assembly",
        "quantity": 1,
        "unit_of_measure": "each",
        "unit_price": {
          "amount": 842.5,
          "currency": "USD"
        },
        "amount": {
          "amount": 842.5,
          "currency": "USD"
        },
        "is_causal": true,
        "part_disposition": "returned"
      },
      {
        "part_number": "24236931",
        "description": "Automatic transmission fluid (quart)",
        "quantity": 8,
        "unit_of_measure": "quart",
        "unit_price": {
          "amount": 12,
          "currency": "USD"
        },
        "amount": {
          "amount": 96,
          "currency": "USD"
        },
        "is_causal": false,
        "part_disposition": "scrapped"
      }
    ],
    "labor_hours": 4.6,
    "labor_amount": {
      "amount": 552,
      "currency": "USD"
    },
    "parts_amount": {
      "amount": 938.5,
      "currency": "USD"
    }
  },
  "requested_amount": {
    "amount": 1490.5,
    "currency": "USD"
  },
  "approved_amount": {
    "amount": 1394.5,
    "currency": "USD"
  },
  "net_amount": {
    "amount": 1394.5,
    "currency": "USD"
  },
  "denial_reason": "Fluid line disallowed: consumable not reimbursable under powertrain coverage for this operation.",
  "rejection_codes": [
    {
      "code": "42",
      "description": "Consumable/fluid not reimbursable on this operation",
      "line_reference": "24236931"
    }
  ],
  "currency_code": "USD",
  "claim_document_url": "https://gmwarranty.example.com/claims/GM-CLM-4471902",
  "submitted_at": "2026-06-24T15:12:00-07:00",
  "decisioned_at": "2026-06-27T09:03:00-07:00",
  "created_at": "2026-06-24T14:50:00-07:00",
  "updated_at": "2026-06-27T09:03:00-07:00",
  "extensions": {
    "dms_claim_type": "warranty",
    "oem_claim_state": "adjusted"
  }
}

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.