Endpoints
- access-groups
- artifacts
- checks
- projects
- deployments
- domains
- dns
- API Reference
- logDrains
- edge-config
- user
- marketplace
- GETGet Account Information
- GETGet Member Information
- POSTCreate Event
- POSTSubmit Billing Data
- POSTSubmit Invoice
- GETGet Invoice
- POSTInvoice Actions
- POSTSubmit Prepayment Balances
- PUTUpdate Resource Secrets (Deprecated)
- PUTUpdate Resource Secrets
- PUTImport Resource
- POSTCreate one or multiple experimentation items
- DELDelete an existing experimentation item
- PATCHPatch an existing experimentation item
- PUTPush data into a user-provided Edge Config
- HEADGet the data of a user-provided Edge Config
- GET
- integrations
- authentication
- logs
- projectMembers
- environment
- security
- teams
- webhooks
- aliases
- certs
marketplace
Submit Billing Data
Sends the billing and usage data. The partner should do this at least once a day and ideally once per hour.
Use the credentials.access_token
we provided in the Upsert Installation body to authorize this request.
POST
/
v1
/
installations
/
{integrationConfigurationId}
/
billing
import { Vercel } from "@vercel/sdk";
const vercel = new Vercel({
bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});
async function run() {
await vercel.marketplace.submitBillingData({
integrationConfigurationId: "<id>",
requestBody: {
timestamp: new Date("2025-09-29T02:38:01.476Z"),
eod: new Date("2023-12-28T23:46:57.523Z"),
period: {
start: new Date("2023-06-25T19:04:50.518Z"),
end: new Date("2024-10-17T01:18:36.230Z"),
},
billing: {
items: [
{
billingPlanId: "<id>",
name: "<value>",
price: "511.92",
quantity: 328.54,
units: "<value>",
total: "<value>",
},
{
billingPlanId: "<id>",
name: "<value>",
price: "4.49",
quantity: 3113.17,
units: "<value>",
total: "<value>",
},
{
billingPlanId: "<id>",
name: "<value>",
price: "896.30",
quantity: 8536.32,
units: "<value>",
total: "<value>",
},
],
},
usage: [
{
name: "<value>",
type: "rate",
units: "<value>",
dayValue: 9439.22,
periodValue: 6958.71,
},
{
name: "<value>",
type: "total",
units: "<value>",
dayValue: 9892.22,
periodValue: 4749.62,
},
{
name: "<value>",
type: "rate",
units: "<value>",
dayValue: 7119.53,
periodValue: 6310.47,
},
],
},
});
}
run();
This response has no body data.
Authorizations
Default authentication mechanism
Path Parameters
Body
application/json
import { Vercel } from "@vercel/sdk";
const vercel = new Vercel({
bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});
async function run() {
await vercel.marketplace.submitBillingData({
integrationConfigurationId: "<id>",
requestBody: {
timestamp: new Date("2025-09-29T02:38:01.476Z"),
eod: new Date("2023-12-28T23:46:57.523Z"),
period: {
start: new Date("2023-06-25T19:04:50.518Z"),
end: new Date("2024-10-17T01:18:36.230Z"),
},
billing: {
items: [
{
billingPlanId: "<id>",
name: "<value>",
price: "511.92",
quantity: 328.54,
units: "<value>",
total: "<value>",
},
{
billingPlanId: "<id>",
name: "<value>",
price: "4.49",
quantity: 3113.17,
units: "<value>",
total: "<value>",
},
{
billingPlanId: "<id>",
name: "<value>",
price: "896.30",
quantity: 8536.32,
units: "<value>",
total: "<value>",
},
],
},
usage: [
{
name: "<value>",
type: "rate",
units: "<value>",
dayValue: 9439.22,
periodValue: 6958.71,
},
{
name: "<value>",
type: "total",
units: "<value>",
dayValue: 9892.22,
periodValue: 4749.62,
},
{
name: "<value>",
type: "rate",
units: "<value>",
dayValue: 7119.53,
periodValue: 6310.47,
},
],
},
});
}
run();
This response has no body data.