> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driv.ly/llms.txt
> Use this file to discover all available pages before exploring further.

# Total Cost of Ownership

<ParamField path="vin" type="string" required>
  The Vehicle Identification Number (e.g. WP0AF2A99KS165242)
</ParamField>

<ParamField query="zip" type="string">
  The ZIP code for the customer, optional, but recommended
</ParamField>

## Response

<ResponseField name="vehicle" type="object" required>
  <Expandable title="properties">
    <ResponseField name="vin" type="string" required>
      The Vehicle Identification Number (e.g. WP0AF2A99KS165242)
    </ResponseField>

    <ResponseField name="year" type="string" required>
      The year of the vehicle (e.g. 2023)
    </ResponseField>

    <ResponseField name="make" type="string" required>
      The make of the vehicle (e.g. Toyota)
    </ResponseField>

    <ResponseField name="model" type="string" required>
      The model of the vehicle (e.g. Tacoma)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="tco" type="object" required>
  <Expandable title="properties">
    <ResponseField name="total" type="object" required>
      <Expandable title="properties">
        <ResponseField name="federalTaxCredit" type="number" required>
          The federal tax credit for the vehicle
        </ResponseField>

        <ResponseField name="insurance" type="number" required>
          The total insurance cost for the vehicle
        </ResponseField>

        <ResponseField name="maintenance" type="number" required>
          The total maintenance cost for the vehicle
        </ResponseField>

        <ResponseField name="repairs" type="number" required>
          The total repairs cost for the vehicle
        </ResponseField>

        <ResponseField name="taxesAndFees" type="number" required>
          The total taxes and fees cost for the vehicle
        </ResponseField>

        <ResponseField name="financeInterest" type="number" required>
          The total finance interest cost for the vehicle
        </ResponseField>

        <ResponseField name="depreciation" type="number" required>
          The total depreciation cost for the vehicle
        </ResponseField>

        <ResponseField name="fuel" type="number" required>
          The total fuel cost for the vehicle
        </ResponseField>

        <ResponseField name="tcoPrice" type="number" required>
          The total cost of ownership price for the vehicle
        </ResponseField>

        <ResponseField name="averageCostPerMile" type="number" required>
          The average cost per mile for the vehicle
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="years" type="object" required>
      An object containing the cost of ownership for each year.\
      Each key is the year number (e.g. 1, 2, 3, 4, 5)

      <Expandable title="properties">
        <ResponseField name="insurance" type="number" required>
          The insurance cost for the year
        </ResponseField>

        <ResponseField name="maintenance" type="number" required>
          The maintenance cost for the year
        </ResponseField>

        <ResponseField name="repairs" type="number" required>
          The repairs cost for the year
        </ResponseField>

        <ResponseField name="taxesAndFees" type="number" required>
          The taxes and fees cost for the year
        </ResponseField>

        <ResponseField name="financeInterest" type="number" required>
          The finance interest cost for the year
        </ResponseField>

        <ResponseField name="depreciation" type="number" required>
          The depreciation cost for the year
        </ResponseField>

        <ResponseField name="fuel" type="number" required>
          The fuel cost for the year
        </ResponseField>

        <ResponseField name="tcoPrice" type="number" required>
          The total cost of ownership price for the year
        </ResponseField>

        <ResponseField name="averageCostPerMile" type="number" required>
          The average cost per mile for the year
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Example (3TYSZ5AN8PT104981) theme={null}
  {
    "vehicle": {
      "vin": "3TYSZ5AN8PT104981",
      "year": "2023",
      "make": "Toyota",
      "model": "Tacoma"
    },
    "zip": "90210",
    "tco": {
      "total": {
        "federalTaxCredit": 0,
        "insurance": 6972,
        "maintenance": 5745,
        "repairs": 887,
        "taxesAndFees": 4435,
        "financeInterest": 7807,
        "depreciation": 13911,
        "fuel": 19829,
        "tcoPrice": 59586,
        "averageCostPerMile": 0.79
      },
      "years": {
        "1": {
          "insurance": 1300,
          "maintenance": 67,
          "repairs": 0,
          "taxesAndFees": 3479,
          "financeInterest": 2663,
          "depreciation": 8500,
          "fuel": 3735,
          "tcoPrice": 19744,
          "averageCostPerMile": 0.79
        },
        "2": {
          "insurance": 1346,
          "maintenance": 530,
          "repairs": 0,
          "taxesAndFees": 252,
          "financeInterest": 2156,
          "depreciation": 1316,
          "fuel": 3847,
          "tcoPrice": 9447,
          "averageCostPerMile": 0.79
        },
        "3": {
          "insurance": 1393,
          "maintenance": 502,
          "repairs": 129,
          "taxesAndFees": 243,
          "financeInterest": 1607,
          "depreciation": 1247,
          "fuel": 3962,
          "tcoPrice": 9083,
          "averageCostPerMile": 0.79
        },
        "4": {
          "insurance": 1441,
          "maintenance": 2147,
          "repairs": 307,
          "taxesAndFees": 235,
          "financeInterest": 1013,
          "depreciation": 1462,
          "fuel": 4081,
          "tcoPrice": 10686,
          "averageCostPerMile": 0.79
        },
        "5": {
          "insurance": 1492,
          "maintenance": 2499,
          "repairs": 451,
          "taxesAndFees": 226,
          "financeInterest": 368,
          "depreciation": 1386,
          "fuel": 4204,
          "tcoPrice": 10626,
          "averageCostPerMile": 0.79
        }
      }
    }
  }
  ```
</ResponseExample>