Introduction

You can access UVDB API through GRAPHQL.

Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

GAPC parts catalog query on GraphQL

Attributes to query

There are over 40 attributes used to identify a vehicle along with dynamic attributes not listed. The identifiers used are decided based on the vehicle category.

Vehicles

  • Year range
  • Make
  • Model
  • Submodel

Engine

  • Engine aspiration
  • Engine version
  • Engine power output
  • Engine fuel type

Body

  • Body type
  • Body doors number
  • Manufacturer body code
See full list→

Use cases

Add a vehicle selector (Year Make Model Filter) with UVDB data to your website

Auto Parts fitment data vehicle selector Year Make Model Filter

Example Queries

UVDB (Universal Vehicle Database) is used to query all information relating to vehicles.

For example, you can query vehicle makes

{
  uvdb {
    vehicle_selector {
      uvdb_makes(limit:500) {
        items {
          id
          name
        }
      }
    }
  }
}

and models, based on the makes

{
  uvdb {
    vehicle_selector {
      uvdb_models(uvdb_make_id:1372, limit:500) {
        items {
          id
          name
        }
      }
    }
  }
}

You can then query vehicle definitions base on the model.

{
 uvdb {
    vehicle_selector {
      uvdb_vehicle_definitions(uvdb_model_id:67209) {
        items {
          uvdb_make {
            name
          }
          uvdb_model {
            name
          }
        }
      }
    }
  }

UVDB for Fitment Data

With UVDB, you can query a vehicle and return all the catalog parts from GAPC that fits.

{
  uvdb {
    vehicle_selector {
      uvdb_makes(limit:500) {
        items {
          id
          name
        }
      }
    }
  }
}

Likewise, you could query a part in GAPC and return all the UVDB vehicles that fits

{
  gapc {
    parts(vehicle: {vehicle_definition_id:1000}, limit:5) {
      items {
        name
        barcode
        gapc_brand {
          name
        }
        gapc_part_type {
          name
        }
      }
    }
  }
}