Skip to main content
POST
/
invoices
Create invoice
curl --request POST \
  --url https://api.vantage.sh/v2/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_period_start": "<string>",
  "billing_period_end": "<string>",
  "account_token": "<string>"
}
'
{
  "token": "<string>",
  "invoice_number": "<string>",
  "total": "<string>",
  "billing_period_start": "<string>",
  "billing_period_end": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "account_token": "<string>",
  "account_name": "<string>",
  "msp_account_token": "<string>"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Create an invoice (MSP accounts only).

​
billing_period_start
string
required

Start date of billing period (YYYY-MM-DD)

​
billing_period_end
string
required

End date of billing period (YYYY-MM-DD)

​
account_token
string
required

Token of the managed account to invoice

Response

Invoice model

​
token
string
​
invoice_number
string

Sequential invoice number for the MSP account

​
total
string

Total amount for the invoice period

​
billing_period_start
string

Start date of the billing period. ISO 8601 formatted.

​
billing_period_end
string

End date of the billing period. ISO 8601 formatted.

​
status
string

Current status of the invoice

​
created_at
string

The date and time, in UTC, the invoice was created. ISO 8601 formatted.

​
updated_at
string

The date and time, in UTC, the invoice was last updated. ISO 8601 formatted.

​
account_token
string

Token of the managed account this invoice belongs to

​
account_name
string

Name of the managed account this invoice belongs to

​
msp_account_token
string

Token of the MSP account that owns this invoice