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

# List dated API versions

> Public discovery of supported X-API-Version release dates (no authentication required). Send the X-API-Version request header (YYYY-MM-DD) to pin a release, or omit it for the latest. Unknown versions return 400 unsupported_api_version.



## OpenAPI

````yaml /openapi/v2.json get /v2/versions
openapi: 3.0.3
info:
  title: Vantr Developer API
  version: v2
  description: >-
    OAuth 2.0 developer access for Vantr v2 APIs on api.vantr.ai. Developer API
    for v2 integrations with scoped access to supported resources. Vantr uses
    vantr.ai for marketing, app.vantr.ai for the web application, and
    api.vantr.ai for API traffic. The developer portal and public docs are
    first-class API-host experiences at api.vantr.ai/developer and
    api.vantr.ai/docs. The application and business API uses /v1 on
    api.vantr.ai. Third-party integrations use /v2 on api.vantr.ai. The current
    v2 API includes scoped access for products, product variations, product and
    variation tags, categories and subcategories, vendors, tenant locations,
    orders with order payments, and usage reporting. Bills are a planned public
    resource with constrained lifecycle rules. Server-side callers may use OAuth
    bearer tokens, direct confidential-client Basic authentication with
    client_id and client_secret, or the x-client-id/x-client-secret header pair
    (the legacy x-invoiceedge-client-id/x-invoiceedge-client-secret names remain
    accepted). Requests are rate limited per credential (240/min on /v2, 60/min
    on the OAuth token endpoints) with RateLimit-* response headers and 429 +
    Retry-After when exceeded. /v2 behavior is versioned by release date: send
    the X-API-Version header (YYYY-MM-DD) to pin a release, or omit it to use
    the latest. Unknown versions return 400 unsupported_api_version, and the
    resolved version is echoed in the X-API-Version response header.
servers:
  - url: https://api.vantr.ai
    description: Vantr API
  - url: http://localhost:8080
    description: Local development
security: []
tags:
  - name: OAuth
    description: OAuth 2.0 token, revocation, and introspection endpoints.
  - name: Capabilities
    description: Discover v2 developer resource capabilities.
  - name: Products
    description: Product, variation, tag, and catalog metadata APIs.
  - name: Categories
    description: Category, subcategory, and classification metadata APIs.
  - name: Vendors
    description: Vendor profile APIs.
  - name: Locations
    description: Read-only tenant location APIs for public location_id discovery.
  - name: Orders
    description: Order and order-payment APIs with lifecycle-constrained writes.
  - name: Webhooks
    description: Register webhook endpoints and subscribe to event streams.
  - name: Usage
    description: Public API usage reporting.
externalDocs:
  description: Vantr public API guide, route catalog, and SDK starters.
  url: https://api.vantr.ai/docs
paths:
  /v2/versions:
    get:
      tags:
        - Capabilities
      summary: List dated API versions
      description: >-
        Public discovery of supported X-API-Version release dates (no
        authentication required). Send the X-API-Version request header
        (YYYY-MM-DD) to pin a release, or omit it for the latest. Unknown
        versions return 400 unsupported_api_version.
      operationId: getApiVersions
      parameters:
        - name: X-API-Version
          in: header
          required: false
          description: >-
            Pin a dated API release (YYYY-MM-DD). Omit for the latest
            (2026-06-09). Unknown values return 400 unsupported_api_version; the
            resolved version is echoed back in the X-API-Version response
            header.
          schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
            example: '2026-06-09'
      responses:
        '200':
          description: Supported API versions, newest marked current.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  header:
                    type: string
                    example: X-API-Version
                  latest:
                    type: string
                    example: '2026-06-09'
                  default:
                    type: string
                    example: '2026-06-09'
                  versions:
                    type: array
                    items:
                      type: object
                      properties:
                        version:
                          type: string
                          example: '2026-06-09'
                        label:
                          type: string
                        description:
                          type: string
                        status:
                          type: string
                          enum:
                            - current
                            - supported

````