Skip to main content

Vantage API

The Vantage API allows users to programmatically access their cost data as well as create cost resources, such as Cost Reports, Folders, Saved Filters, and Dashboards.

You can access the API documentation to read more about available endpoints and associated endpoint parameters. You can also perform API calls directly from the documentation.

Important

Keep in mind that when using the API reference tool to perform API calls, you are working with your live data.

When viewing an endpoint, all available parameters will be listed on the corresponding API documentation page, along with any requirements.

API documentation

The above image shows a sample POST call to the /folders endpoint.

  • To get started, enter your API token in the Authorization field.
  • The body parameters title, parent_folder_token, saved_filter_token, and workspace_token are displayed, along with a sample request.
  • You can choose to display the request in numerous programming languages, such as Python, Ruby, or JavaScript.
  • Click the Try It! button. The Response and any errors are displayed below the request.

API Versions

Two versions of the API are available in the documentation:

  • v1.1.0: With v1 of the API, you can view providers (AWS only for this version), services, and products. You can also view Cost Reports. See the v1 API documentation for more information.
  • v2.0: v2 of the API offers expanded functionality. You can automate the management and creation of Cost Reports, Folders, Dashboards, and Saved Filters. You can also create and manage teams and resource access grants. See the v2 API documentation for more information.

Get Started with the API

Start icon

API Quickstart

Get started with the Vantage API. Understand the API schema and how to call various endpoints.

API icon

API Authentication

Learn how to authenticate and access the Vantage API. Create an API access token with Read and Write scopes enabled.

Query logo

Vantage Query Language (VQL)

Vantage Query Language (VQL) is a SQL-like language designed to filter cloud cost data. VQL provides a normalized schema across various cloud providers.

Dictionary icon

Data Dictionary

Consult the Data Dictionary to view the normalized field names used to create VQL statements. Each provider that Vantage integrates with makes different fields available in their billing data.