--- title: submit-billing-data product: vercel url: /docs/rest-api/marketplace/submit-billing-data canonical_url: "https://vercel.com/docs/rest-api/marketplace/submit-billing-data" last_updated: 2026-09-14 type: reference prerequisites: [] related: - /docs/rest-api summary: Learn about submit-billing-data on Vercel. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Submit Billing Data ```http POST /v1/installations/{integrationConfigurationId}/billing ``` 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](#upsert-installation) body to authorize this request. ## Authentication **bearerToken**: HTTP bearer ## Path parameters | Name | Type | Required | Description | |---|---|---|---| | `integrationConfigurationId` | string | Yes | | ## Request body Required: Yes Content-Type: `application/json` ```json { "type": "object", "required": [ "timestamp", "eod", "period", "billing", "usage" ], "properties": { "timestamp": { "type": "string", "description": "Server time of your integration, used to determine the most recent data for race conditions & updates. Only the latest usage data for a given day, week, and month will be kept.", "format": "date-time" }, "eod": { "type": "string", "description": "End of Day, the UTC datetime for when the end of the billing/usage day is in UTC time. This tells us which day the usage data is for, and also allows for your \"end of day\" to be different from UTC 00:00:00. eod must be within the period dates, and cannot be older than 24h earlier from our server's current time.", "format": "date-time" }, "period": { "type": "object", "description": "Period for the billing cycle. The period end date cannot be older than 24 hours earlier than our current server's time.", "required": [ "start", "end" ], "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" } } }, "billing": { "description": "Billing data (interim invoicing data).", "oneOf": [ { "type": "array", "items": { "type": "object", "required": [ "billingPlanId", "name", "price", "quantity", "units", "total" ] } }, { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array" }, "discounts": { "type": "array" } } } ] }, "usage": { "type": "array", "items": { "type": "object", "required": [ "name", "type", "units", "dayValue", "periodValue" ], "properties": { "resourceId": { "type": "string", "description": "Partner's resource ID." }, "name": { "type": "string", "description": "Metric name." }, "type": { "type": "string", "description": "\n Type of the metric.\n - total: measured total value, such as Database size\n - interval: usage during the period, such as i/o or number of queries.\n - rate: rate of usage, such as queries per second.\n ", "enum": [ "total", "interval", "rate" ] }, "units": { "type": "string", "description": "Metric units. Example: \"GB\"" }, "dayValue": { "type": "number", "description": "Metric value for the day. Could be a final or an interim value for the day." }, "periodValue": { "type": "number", "description": "Metric value for the billing period. Could be a final or an interim value for the period." }, "planValue": { "type": "number", "description": "The limit value of the metric for a billing period, if a limit is defined by the plan." } } } } } } ``` ## Example request ### TypeScript ```typescript const response = await fetch('https://api.vercel.com/v1/installations/integrationConfigurationId/billing', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ "timestamp": "2024-01-01T00:00:00Z", "eod": "2024-01-01T00:00:00Z", "period": { "start": "2024-01-01T00:00:00Z", "end": "2024-01-01T00:00:00Z" }, "billing": [ { "billingPlanId": "example_id", "resourceId": "example_id", "start": "2024-01-01T00:00:00Z", "end": "2024-01-01T00:00:00Z", "name": "Example Name", "details": "Example details", "price": "100.00", "quantity": "1", "units": "units", "total": "100.00" } ], "usage": [ { "resourceId": "example_id", "name": "Example Name", "type": "total", "units": "units", "dayValue": "123", "periodValue": "123", "planValue": "123" } ] }), }); const data = await response.json(); console.log(data); ``` ### Next.js ```typescript 'use server'; export async function callEndpoint() { const response = await fetch('https://api.vercel.com/v1/installations/integrationConfigurationId/billing', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.VERCEL_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "timestamp": "2024-01-01T00:00:00Z", "eod": "2024-01-01T00:00:00Z", "period": { "start": "2024-01-01T00:00:00Z", "end": "2024-01-01T00:00:00Z" }, "billing": [ { "billingPlanId": "example_id", "resourceId": "example_id", "start": "2024-01-01T00:00:00Z", "end": "2024-01-01T00:00:00Z", "name": "Example Name", "details": "Example details", "price": "100.00", "quantity": "1", "units": "units", "total": "100.00" } ], "usage": [ { "resourceId": "example_id", "name": "Example Name", "type": "total", "units": "units", "dayValue": "123", "periodValue": "123", "planValue": "123" } ] }), next: { revalidate: 3600 } }); if (!response.ok) { throw new Error('Request failed'); } return response.json(); } ``` ### cURL ```bash curl -X POST 'https://api.vercel.com/v1/installations/integrationConfigurationId/billing' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d "{ \"timestamp\": \"2024-01-01T00:00:00Z\", \"eod\": \"2024-01-01T00:00:00Z\", \"period\": { \"start\": \"2024-01-01T00:00:00Z\", \"end\": \"2024-01-01T00:00:00Z\" }, \"billing\": [ { \"billingPlanId\": \"example_id\", \"resourceId\": \"example_id\", \"start\": \"2024-01-01T00:00:00Z\", \"end\": \"2024-01-01T00:00:00Z\", \"name\": \"Example Name\", \"details\": \"Example details\", \"price\": \"100.00\", \"quantity\": \"1\", \"units\": \"units\", \"total\": \"100.00\" } ], \"usage\": [ { \"resourceId\": \"example_id\", \"name\": \"Example Name\", \"type\": \"total\", \"units\": \"units\", \"dayValue\": \"123\", \"periodValue\": \"123\", \"planValue\": \"123\" } ] }" ``` ## Responses ### 201: No description ### 400: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid. ### 401: The request is not authorized. ### 403: You do not have permission to access this resource. ### 404: No description ### 410: No description --- ## Related - [marketplace endpoints](/docs/rest-api#marketplace) - [REST API overview](/docs/rest-api) - [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints) --- [View full sitemap](/docs/sitemap)