find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/vinaudit-getownershipcost-php-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: VINaudit Vehicle Ownership Cost Getownershipcost.php API
  description: Calculate 5-year total cost of ownership by VIN, factoring in depreciation, insurance, fuel, maintenance, repairs, and state fees and taxes. Returns itemized yearly cost breakdowns and a cumulative 5-year total.
  version: '1.0'
  contact:
    name: VINaudit Support
    url: https://www.vinaudit.com/vehicle-data-api
  license:
    name: Commercial
    url: https://www.vinaudit.com/vehicle-ownership-cost-api
servers:
- url: http://ownershipcost.vinaudit.com
  description: VINaudit Vehicle Ownership Cost API
tags:
- name: Getownershipcost.php
paths:
  /getownershipcost.php:
    get:
      operationId: getOwnershipCost
      summary: Get Vehicle 5-Year Ownership Cost
      description: Calculate the estimated 5-year total cost of ownership for a vehicle identified by VIN. Returns itemized yearly cost arrays for depreciation, insurance, fuel, maintenance, repairs, and state fees/taxes, plus a cumulative 5-year total. The state parameter is required to apply location-specific fee and tax calculations.
      parameters:
      - name: vin
        in: query
        required: true
        description: 17-character Vehicle Identification Number
        schema:
          type: string
          example: 1NXBR32E85Z505904
      - name: key
        in: query
        required: true
        description: API authentication key
        schema:
          type: string
          example: YOUR_API_KEY_HERE
      - name: state
        in: query
        required: true
        description: Two-letter US state code for location-specific tax and fee calculation
        schema:
          type: string
          minLength: 2
          maxLength: 2
          example: WA
      - name: format
        in: query
        required: false
        description: Response format
        schema:
          type: string
          enum:
          - json
          default: json
      responses:
        '200':
          description: Vehicle 5-year ownership cost response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnershipCostResponse'
      tags:
      - Getownershipcost.php
    post:
      operationId: getOwnershipCostPost
      summary: Get Vehicle 5-Year Ownership Cost (POST)
      description: Calculate the estimated 5-year total cost of ownership using POST method.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - vin
              - key
              - state
              properties:
                vin:
                  type: string
                  description: 17-character Vehicle Identification Number
                key:
                  type: string
                  description: API authentication key
                state:
                  type: string
                  description: Two-letter US state code
                format:
                  type: string
                  enum:
                  - json
      responses:
        '200':
          description: Vehicle 5-year ownership cost response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnershipCostResponse'
      tags:
      - Getownershipcost.php
components:
  schemas:
    YearlyCostArray:
      type: array
      description: Array of 5 yearly cost values (year 1 through year 5)
      items:
        type: number
        description: Cost in dollars for that year
      minItems: 5
      maxItems: 5
    OwnershipCostResponse:
      type: object
      description: 5-year vehicle ownership cost response
      properties:
        vin:
          type: string
          description: Vehicle Identification Number
          example: 1NXBR32E85Z505904
        mileage_start:
          type: integer
          description: Current vehicle mileage (-1 if unknown)
          example: -1
        mileage_year:
          type: integer
          description: Annual mileage estimate used in calculation
          default: 15000
          example: 15000
        vehicle:
          type: string
          description: Full vehicle description (Year Make Model Trim)
          example: 2005 Toyota Corolla CE
        depreciation_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        insurance_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        fuel_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        maintenance_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        repairs_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        fees_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        total_cost:
          $ref: '#/components/schemas/YearlyCostArray'
        total_cost_sum:
          type: number
          description: Cumulative 5-year total cost of ownership
          example: 38500.0
        success:
          type: boolean
          description: Whether the ownership cost calculation was successful
        error:
          type: string
          description: Error message or empty string if successful
          example: ''