Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/vantage-sh-unitcosts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Vantage Unit Costs API
description: The Vantage API provides programmatic access to the Vantage cloud cost management and FinOps platform.
termsOfService: https://www.vantage.sh/terms-of-use
contact:
name: Vantage Support
url: https://www.vantage.sh
email: support@vantage.sh
version: 2.0.0
servers:
- url: https://api.vantage.sh/v2
security:
- oauth2:
- read
tags:
- name: UnitCosts
description: Operations about UnitCosts
paths:
/unit_costs/data_exports:
post:
tags:
- UnitCosts
summary: Generate data export of unit costs
description: Generate a DataExport of unit costs.
operationId: createUnitCostsExport
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/createUnitCostsExport'
required: true
responses:
'202':
description: The data export has been queued and will be available at the location specified in the Location header.
content:
application/json:
schema:
$ref: '#/components/schemas/DataExport'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'402':
description: PaymentRequired
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- read
x-codegen-request-body-name: createUnitCostsExport
/unit_costs:
get:
tags:
- UnitCosts
summary: Get all unit costs for a cost report
description: Return all UnitCosts for a CostReport.
operationId: getUnitCosts
parameters:
- name: cost_report_token
in: query
description: The CostReport token.
required: true
schema:
type: string
- name: start_date
in: query
description: First date you would like to filter unit costs from. Defaults to the report's default. ISO 8601 formatted.
schema:
type: string
- name: end_date
in: query
description: Last date you would like to filter unit costs to. Defaults to the report's default. ISO 8601 formatted.
schema:
type: string
- name: date_bin
in: query
description: The date bin of the unit costs. Defaults to the report's default or day.
schema:
type: string
enum:
- day
- week
- month
- quarter
- hour
- name: order
in: query
description: Whether to order unit costs by date in an ascending or descending manner.
schema:
type: string
default: desc
enum:
- asc
- desc
- name: limit
in: query
description: The amount of results to return. The maximum is 1000.
schema:
type: integer
format: int32
- name: page
in: query
description: The page of results to return.
schema:
type: integer
format: int32
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UnitCosts'
example:
links:
self: https://api.vantage.sh/v2/unit_costs?cost_report_token=rprt_ea7dbb4f5783d677
first: https://api.vantage.sh/v2/unit_costs?cost_report_token=rprt_ea7dbb4f5783d677&page=1
next: null
last: null
prev: null
unit_costs:
- business_metric_token: bsnss_mtrc_3080a050c04104ff
business_metric_title: Biz Metric
unit_cost_amount: '21.7'
business_metric_amount: '3.71'
scale: '1.0'
date: '2023-06-05'
- business_metric_token: bsnss_mtrc_4999b969d95095ef
business_metric_title: Different Biz Metric
unit_cost_amount: '101.11'
business_metric_amount: '43.21'
scale: '1.0'
date: '2023-06-05'
- business_metric_token: bsnss_mtrc_3080a050c04104ff
business_metric_title: Biz Metric
unit_cost_amount: '18.9'
business_metric_amount: '3.71'
scale: '1.0'
date: '2023-06-06'
- business_metric_token: bsnss_mtrc_4999b969d95095ef
business_metric_title: Different Biz Metric
unit_cost_amount: '121.12'
business_metric_amount: '38.1'
scale: '1.0'
date: '2023-06-06'
- business_metric_token: bsnss_mtrc_3080a050c04104ff
business_metric_title: Biz Metric
unit_cost_amount: '21.2'
business_metric_amount: '3.51'
scale: '1.0'
date: '2023-06-07'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'402':
description: PaymentRequired
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- read
components:
schemas:
DataExportManifest:
required:
- completed_at
- files
- valid_until
type: object
properties:
files:
type: array
items:
type: string
example: ''
completed_at:
type:
- string
- 'null'
example: '2025-03-20T12:00:00Z'
valid_until:
type:
- string
- 'null'
example: '2025-03-20T12:00:00Z'
Errors:
required:
- errors
type: object
properties:
links:
$ref: '#/components/schemas/Links'
errors:
type: array
items:
type: string
description: Errors model
Links:
type: object
properties:
self:
type:
- string
- 'null'
description: The URL of the current page of results.
first:
type:
- string
- 'null'
description: The URL of the first page of results.
next:
type:
- string
- 'null'
description: The URL of the next page of results, if one exists.
last:
type:
- string
- 'null'
description: The URL of the last page of results, if one exists.
prev:
type:
- string
- 'null'
description: The URL of the previous page of results, if one exists.
DataExport:
required:
- attributes
- created_at
- export_type
- manifest
- status
- token
type: object
properties:
token:
type: string
example: dta_xprt_abcd1234567890
status:
type: string
example: pending
created_at:
type: string
example: '2025-03-20T12:00:00Z'
export_type:
type: string
example: cost_report
manifest:
$ref: '#/components/schemas/DataExportManifest'
attributes:
type: object
properties: {}
description: DataExport model
UnitCost:
required:
- business_metric_amount
- business_metric_title
- business_metric_token
- date
- scale
- unit_cost_amount
type: object
properties:
links:
$ref: '#/components/schemas/Links'
business_metric_token:
type: string
description: The token of the BusinessMetric for which the unit cost was calculated.
example: bsnss_mtrc_1234
business_metric_title:
type: string
description: The title of the BusinessMetric for which the unit cost was calculated.
example: Total Revenue
calculation_type:
type:
- string
- 'null'
description: The calculation type applied to produce this result.
example: unit_cost
enum:
- unit_cost
- gross_margin
- usage_unit_cost
- raw_business_metric
unit_cost_amount:
type: string
description: The amount of the unit cost. For raw_business_metric types, this equals the business_metric_amount.
example: '4.25'
business_metric_amount:
type: string
description: The amount of the business metric.
example: '0.371'
scale:
type: number
description: The scale of the BusinessMetric's values within a particular CostReport.
format: float
example: 1.0
date:
type: string
description: The date for which the unit cost was calculated. ISO 8601 Formatted.
example: 2023-09-05+00:00
UnitCosts:
required:
- unit_costs
type: object
properties:
links:
$ref: '#/components/schemas/Links'
unit_costs:
type: array
items:
$ref: '#/components/schemas/UnitCost'
description: UnitCosts model
createUnitCostsExport:
required:
- cost_report_token
type: object
properties:
cost_report_token:
type: string
description: The CostReport token.
workspace_token:
type: string
description: The token of the Workspace to query costs from. Required if the API token is associated with multiple Workspaces.
start_date:
type: string
description: First date you would like to filter unit costs from. Defaults to the report's default. ISO 8601 formatted.
end_date:
type: string
description: Last date you would like to filter unit costs to. Defaults to the report's default. ISO 8601 formatted.
date_bin:
type: string
description: The date bin of the unit costs. Defaults to the report's default or day.
enum:
- day
- week
- month
- quarter
- hour
description: Generate a DataExport of unit costs.
securitySchemes:
oauth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://console.vantage.sh/account/profile
scopes:
read: Grants read access
write: Grants write access
x-original-swagger-version: '2.0'