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-billing-profiles-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 Billing Profiles 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: Billing Profiles
description: Operations about BillingProfiles
paths:
/billing_profiles:
get:
tags:
- Billing Profiles
summary: Get all billing profiles
description: Returns a list of billing profiles (MSP invoicing required).
operationId: getBillingProfiles
parameters:
- name: page
in: query
description: The page of results to return.
schema:
type: integer
format: int32
- name: limit
in: query
description: The amount of results to return. The maximum is 1000.
schema:
type: integer
format: int32
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfiles'
security:
- oauth2:
- read
post:
tags:
- Billing Profiles
summary: Create billing profile
description: Create a billing profile (MSP invoicing required).
operationId: createBillingProfile
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/createBillingProfile'
required: true
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
x-codegen-request-body-name: createBillingProfile
/billing_profiles/{billing_profile_token}:
get:
tags:
- Billing Profiles
summary: Get billing profile by token
description: Requires MSP invoicing to be enabled on the account.
operationId: getBillingProfile
parameters:
- name: billing_profile_token
in: path
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- read
put:
tags:
- Billing Profiles
summary: Update billing profile
description: Requires MSP invoicing to be enabled on the account.
operationId: updateBillingProfile
parameters:
- name: billing_profile_token
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/updateBillingProfile'
required: true
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
x-codegen-request-body-name: updateBillingProfile
delete:
tags:
- Billing Profiles
summary: Delete billing profile
description: Requires MSP invoicing to be enabled on the account.
operationId: deleteBillingProfile
parameters:
- name: billing_profile_token
in: path
required: true
schema:
type: string
responses:
'204':
description: Billing Profile deleted successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
components:
schemas:
BusinessInformation:
required:
- token
type: object
properties:
token:
type: string
metadata:
$ref: '#/components/schemas/BusinessInformationMetadata'
BillingProfiles:
required:
- billing_profiles
type: object
properties:
links:
$ref: '#/components/schemas/Links'
billing_profiles:
type: array
items:
$ref: '#/components/schemas/BillingProfile'
description: BillingProfiles model
AdjustmentItem:
required:
- adjustment_type
- amount
- calculation_type
- name
type: object
properties:
name:
type: string
description: Name of the adjustment (e.g., 'State Tax', 'Processing Fee')
adjustment_type:
type: string
description: Type of adjustment
enum:
- charge
- credit
- discount
calculation_type:
type: string
description: How the adjustment is calculated
enum:
- fixed
- percentage
amount:
type: string
description: Amount or percentage value for the adjustment
BankingInformationSecureData:
required:
- account_number
- iban
- routing_number
- swift_bic
type: object
properties:
account_number:
type:
- string
- 'null'
description: Bank account number (US)
routing_number:
type:
- string
- 'null'
description: Bank routing number (US)
iban:
type:
- string
- 'null'
description: International Bank Account Number (EU)
swift_bic:
type:
- string
- 'null'
description: SWIFT/BIC code (EU)
BusinessInformationCustomField:
required:
- name
- value
type: object
properties:
name:
type: string
description: Custom field name
value:
type:
- string
- 'null'
description: Custom field value
InvoiceAdjustment:
required:
- adjustment_items
- token
type: object
properties:
token:
type: string
adjustment_items:
type: array
description: Array of adjustment items (taxes, fees, etc.)
items:
$ref: '#/components/schemas/AdjustmentItem'
BillingProfile:
required:
- billing_information_attributes
- business_information_attributes
- created_at
- invoice_adjustment_attributes
- managed_accounts_count
- nickname
- token
- updated_at
type: object
properties:
token:
type: string
nickname:
type: string
description: Display name for the billing profile
created_at:
type: string
description: The date and time, in UTC, the billing profile was created. ISO 8601 formatted.
example: '2023-08-04T00:00:00Z'
updated_at:
type: string
description: The date and time, in UTC, the billing profile was last updated. ISO 8601 formatted.
example: '2023-08-04T00:00:00Z'
billing_information_attributes:
$ref: '#/components/schemas/BillingInformation'
business_information_attributes:
$ref: '#/components/schemas/BusinessInformation'
banking_information_attributes:
$ref: '#/components/schemas/BankingInformation'
invoice_adjustment_attributes:
$ref: '#/components/schemas/InvoiceAdjustment'
managed_accounts_count:
type: string
description: Number of managed accounts using this billing profile
description: BillingProfile model
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.
updateBillingProfile:
type: object
properties:
nickname:
type: string
description: Display name for the billing profile
billing_information_attributes:
type: object
properties:
token:
type: string
company_name:
type: string
description: Company name for billing
country_code:
type: string
description: ISO country code
address_line_1:
type: string
description: First line of billing address
address_line_2:
type: string
description: Second line of billing address
city:
type: string
description: City for billing address
state:
type: string
description: State or province for billing address
postal_code:
type: string
description: Postal or ZIP code
billing_email:
type: array
description: Array of billing email addresses
items:
type: string
description: Billing address and contact information
business_information_attributes:
type: object
properties:
token:
type: string
metadata:
type: object
properties:
custom_fields:
type: array
description: Array of custom field objects
items:
type: object
properties:
name:
type: string
description: Custom field name
value:
type: string
description: Custom field value
description: Business metadata including custom fields
description: Business information and custom fields
banking_information_attributes:
type: object
properties:
token:
type: string
bank_name:
type: string
description: Name of the bank
beneficiary_name:
type: string
description: Name of the account beneficiary
tax_id:
type: string
description: Tax identification number
secure_data:
type: object
properties:
account_number:
type: string
description: Bank account number (US)
routing_number:
type: string
description: Bank routing number (US)
iban:
type: string
description: International Bank Account Number (EU)
swift_bic:
type: string
description: SWIFT/BIC code (EU)
description: Encrypted banking details
description: Banking details (MSP accounts only)
invoice_adjustment_attributes:
type: object
properties:
token:
type: string
adjustment_items:
type: array
description: Array of adjustment items
items:
required:
- amount
- calculation_type
- name
type: object
properties:
name:
type: string
description: Name of the adjustment
adjustment_type:
type: string
description: Type of adjustment
default: charge
enum:
- charge
- credit
- discount
calculation_type:
type: string
description: How the adjustment is calculated
enum:
- fixed
- percentage
amount:
type: number
description: Amount or percentage value
format: double
description: Invoice adjustments (taxes, fees, etc.)
description: Update a billing profile (MSP invoicing required).
BankingInformation:
required:
- bank_name
- beneficiary_name
- tax_id
- token
type: object
properties:
token:
type: string
bank_name:
type:
- string
- 'null'
description: Name of the bank
beneficiary_name:
type:
- string
- 'null'
description: Name of the account beneficiary
tax_id:
type:
- string
- 'null'
description: Tax identification number
secure_data:
$ref: '#/components/schemas/BankingInformationSecureData'
BusinessInformationMetadata:
type: object
properties:
custom_fields:
type: array
description: Array of custom field objects
items:
$ref: '#/components/schemas/BusinessInformationCustomField'
BillingInformation:
required:
- address_line_1
- address_line_2
- billing_email
- city
- company_name
- country_code
- postal_code
- state
- token
type: object
properties:
token:
type: string
company_name:
type:
- string
- 'null'
description: Company name for billing
country_code:
type:
- string
- 'null'
description: ISO country code
address_line_1:
type:
- string
- 'null'
description: First line of billing address
address_line_2:
type:
- string
- 'null'
description: Second line of billing address
city:
type:
- string
- 'null'
description: City for billing address
state:
type:
- string
- 'null'
description: State or province for billing address
postal_code:
type:
- string
- 'null'
description: Postal or ZIP code
billing_email:
type:
- array
- 'null'
description: Array of billing email addresses
items:
type: string
createBillingProfile:
required:
- nickname
type: object
properties:
nickname:
type: string
description: Display name for the billing profile
billing_information_attributes:
type: object
properties:
token:
type: string
company_name:
type: string
description: Company name for billing
country_code:
type: string
description: ISO country code
address_line_1:
type: string
description: First line of billing address
address_line_2:
type: string
description: Second line of billing address
city:
type: string
description: City for billing address
state:
type: string
description: State or province for billing address
postal_code:
type: string
description: Postal or ZIP code
billing_email:
type: array
description: Array of billing email addresses
items:
type: string
description: Billing address and contact information
business_information_attributes:
type: object
properties:
token:
type: string
metadata:
type: object
properties:
custom_fields:
type: array
description: Array of custom field objects
items:
type: object
properties:
name:
type: string
description: Custom field name
value:
type: string
description: Custom field value
description: Business metadata including custom fields
description: Business information and custom fields
banking_information_attributes:
type: object
properties:
token:
type: string
bank_name:
type: string
description: Name of the bank
beneficiary_name:
type: string
description: Name of the account beneficiary
tax_id:
type: string
description: Tax identification number
secure_data:
type: object
properties:
account_number:
type: string
description: Bank account number (US)
routing_number:
type: string
description: Bank routing number (US)
iban:
type: string
description: International Bank Account Number (EU)
swift_bic:
type: string
description: SWIFT/BIC code (EU)
description: Encrypted banking details
description: Banking details (MSP accounts only)
invoice_adjustment_attributes:
type: object
properties:
token:
type: string
adjustment_items:
type: array
description: Array of adjustment items
items:
required:
- amount
- calculation_type
- name
type: object
properties:
name:
type: string
description: Name of the adjustment
adjustment_type:
type: string
description: Type of adjustment
default: charge
enum:
- charge
- credit
- discount
calculation_type:
type: string
description: How the adjustment is calculated
enum:
- fixed
- percentage
amount:
type: number
description: Amount or percentage value
format: double
description: Invoice adjustments (taxes, fees, etc.)
description: Create a billing profile (MSP invoicing required).
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'