API V2.1
========

The GroupVAN API V2.1 provides catalog, search, and member services for
building automotive aftermarket applications.

Base URL
--------

.. list-table::
   :header-rows: 1
   :widths: 30 70

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

Authentication
--------------

All V2.1 endpoints require a valid JWT Bearer token in the request header.

.. code-block:: none

    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Available Services
------------------

**Catalog**

.. list-table::
   :header-rows: 1
   :widths: 25 10 40 25

   * - Service
     - Method
     - Endpoint
     - Description
   * - :doc:`Vehicles <catalog/vehicles>`
     - POST
     - ``/v2_1/catalog/vehicles``
     - Query vehicle data
   * - :doc:`Top Categories <catalog/top-categories>`
     - GET
     - ``/v2_1/catalog/top_categories``
     - List top categories
   * - :doc:`Categories <catalog/categories>`
     - POST
     - ``/v2_1/catalog/categories``
     - Query categories and part types
   * - :doc:`Products <catalog/products>`
     - POST
     - ``/v2_1/catalog/products``
     - Query products and fitment data
   * - :doc:`Products Assets <catalog/products-assets>`
     - POST
     - ``/v2_1/catalog/products/assets``
     - Retrieve product assets
   * - :doc:`Product Info <catalog/product-info>`
     - POST
     - ``/v2_1/catalog/product/info``
     - Fetch product information
   * - :doc:`Application Assets <catalog/applications-assets>`
     - POST
     - ``/v2_1/catalog/applications/assets``
     - Retrieve application assets
   * - :doc:`Buyer's Guide <catalog/buyers-guide>`
     - POST
     - ``/v2_1/catalog/buyers_guide``
     - Query buyer's guide data
   * - :doc:`Interchange <catalog/interchange>`
     - POST
     - ``/v2_1/catalog/interchange``
     - Query interchange data

**Search**

.. list-table::
   :header-rows: 1
   :widths: 25 10 40 25

   * - Service
     - Method
     - Endpoint
     - Description
   * - :doc:`Products <search/products>`
     - GET
     - ``/v2_1/search/products``
     - Search product information
   * - :doc:`Vehicles <search/vehicles>`
     - GET
     - ``/v2_1/search/vehicles``
     - Search vehicle information
   * - :doc:`VIN <search/vin>`
     - GET
     - ``/v2_1/search/vin``
     - Look up vehicle by VIN
   * - :doc:`Plate <search/plate>`
     - GET
     - ``/v2_1/search/plate``
     - Look up vehicle by license plate

**Member**

.. list-table::
   :header-rows: 1
   :widths: 25 10 40 25

   * - Service
     - Method
     - Endpoint
     - Description
   * - :doc:`Account Search <member/account_search>`
     - GET
     - ``/v2_1/member/account_search``
     - Search accounts

.. toctree::
   :maxdepth: 2
   :hidden:

   catalog/index
   search/index
   member/index
   reference