API V3

The GroupVAN API V3 provides catalog and vehicle services with an improved query-parameter interface for building automotive aftermarket applications.

Base URL

Environment	URL
Production	https://api.groupvan.com
Staging	https://api.staging.groupvan.com

Authentication

All V3 endpoints require a valid JWT Bearer token in the request header. See Authentication for details on generating a self-signed JWT.

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Available Services

Catalogs

Service	Method	Endpoint	Description
List	GET	/v3/catalogs/list	Query available catalogs
Vehicle Categories	GET	/v3/catalogs/{id}/vehicle/{index}/categories	Retrieve categories for a vehicle
Supply Categories	GET	/v3/catalogs/{id}/categories	Retrieve supply categories
Application Assets	GET	/v3/catalogs/application_assets	Retrieve application media assets
Cart	GET	/v3/catalogs/cart/{cart_id}	Retrieve cart contents
Product Info	GET	/v3/catalogs/product/info	Retrieve product information

Vehicles

Service	Method	Endpoint	Description
Plate	GET	/v3/vehicles/plate	Look up vehicle by license plate
VIN	GET	/v3/vehicles/vin	Look up vehicle by VIN
User	GET	/v3/vehicles/user	Query user’s recent vehicles
Fleets	GET	/v3/vehicles/fleets	Query user’s fleets
Account	GET	/v3/vehicles/account	Query account vehicles
Groups	GET	/v3/vehicles/groups	Query vehicle groups
Filter	GET	/v3/vehicles/filter	Filter vehicles by criteria
Engines	GET	/v3/vehicles/engines	Query engine configurations
Search	GET	/v3/vehicles/search	Search for vehicles