[metadata]
color-scheme: dark light
description: Purchases credits for a Vercel team using the default payment method on file. The purchase is charged immediately via Stripe invoice. Supported credit types are `v0`, `gateway`, and `agent`. The `amount` field specifies the number of credits to purchase and must be a positive integer. An optional `source` query parameter can be provided to identify the caller. Defaults to `api` if not specified. This is only available for Owner, Member, Developer, Security, and Billing roles for the supplied team.
googlebot: index, max-video-preview:-1, max-image-preview:large, max-snippet:-1
initiator-trace: 00-d414060eb6a93806009576c477bb4983-81988254047422c3-01
robots: index, follow
theme-color: #000000
theme-color: #fafafa
trace-attributes: {"next.appdir":true}
viewport: width=device-width, initial-scale=1, maximum-scale=1, viewport-fit=cover

[canonical-links]
https://vercel.com/docs/rest-api/billing/purchase-credits

[document-links]
/home
AI Apps: /solutions/ai-apps
AI Gateway: /ai-gateway
AI Gateway: /docs/ai-gateway
AI Integrations: /docs/agent-resources/integrations-for-models
AI SDK: /ai-sdk
AI SDK: /docs/ai-sdk
APIs & SDKs: /docs/rest-api
About: /about
Academy: /academy
Acceptable Use Policy: /legal/acceptable-use-policy
Agent Skills: https://skills.sh
All frameworks: /docs/frameworks
Articles: /i
Blog ↗: https://vercel.com/blog
Blog: /blog
Bot Management: /docs/bot-management
Bot Management: /security/bot-management
BotID: /botid
BotID: /docs/botid
CI/CD: /products/previews
CLI: /docs/cli
Careers: /careers
Changelog ↗: https://vercel.com/changelog
Changelog: /changelog
Chat SDK New: /chat
Commerce: /solutions/composable-commerce
Community ↗: https://community.vercel.com
Community: https://community.vercel.com
Compliance: /docs/security/compliance
Connect New: /connect
Container Registry: /docs/container-registry
Content Delivery: /cdn
Cookie Policy: /legal/cookie-policy
Customers: /customers
DPA: /legal/dpa
Delivery Network: /docs/cdn
Deployment Protection: /docs/deployment-protection
Deployments: /docs/deployments
Design Engineers: /solutions/design-engineering
Docs: /docs
Domains: /docs/domains
Domains: /domains
Enterprise: /enterprise
Errors: /docs/rest-api/errors
Events: /events
FastAPI: /docs/frameworks/backend/fastapi
Feature Flags: /docs/flags
Firewall: /docs/vercel-firewall
Flags SDK: /docs/flags/flags-sdk-reference
Fluid Compute: /fluid
Functions: /docs/functions
GET List FOCUS Billing Charges: /docs/rest-api/billing/list-focus-billing-charges
GET List FOCUS Contract Commitments: /docs/rest-api/billing/list-focus-contract-commitments
Get Invoice: https://vercel.com/docs/rest-api/marketplace/get-invoice?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=semantic&surface=html
Get rolling release billing status: https://vercel.com/docs/rest-api/rolling-release/get-rolling-release-billing-status?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=semantic&surface=html
Getting Started: /docs/getting-started-with-vercel
Getting Started: /docs/rest-api/getting-started
GitHub: https://github.com/vercel
Help: /help
Instagram: https://www.instagram.com/vercel/
Integrations: /docs/integrations
Is Agentic: https://is-agentic.com
Knowledge Base: /kb
Legal (all documents): /legal
LinkedIn: https://linkedin.com/company/vercel
List FOCUS billing charges: https://vercel.com/docs/rest-api/billing/list-focus-billing-charges?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=semantic&surface=html
Log In: /login
Marketing Sites: /solutions/marketing-sites
Marketplace: /marketplace
Microfrontends: /docs/microfrontends
Next.js: /frameworks/nextjs
Nitro: /docs/frameworks/backend/nitro
Nuxt: /docs/frameworks/full-stack/nuxt
Observability: /docs/observability
Observability: /products/observability
Open Source Program: /open-source-program
OpenAPI Specification: https://openapi.vercel.sh/
Overview: /docs/rest-api
POST Purchase Credits: /docs/rest-api/billing/purchase-credits
Partner Finder: /partners/solution-partners
Passport New: /passport
Platform Engineers: /solutions/platform-engineering
Platform Security: /security
Platforms: /solutions/multi-tenant-saas
Press: /press
Pricing: /pricing
Privacy Policy: /legal/privacy-policy
Queues SDK New: /docs/queues/sdk
Sandbox: /docs/sandbox
Sandbox: /sandbox
Shipped on Vercel: /shipped
Sign Up: /signup
Startups: /startups
Status: https://www.vercel-status.com
Storage: /docs/storage
Streamdown: https://streamdown.ai
Submit Billing Data: https://vercel.com/docs/rest-api/marketplace/submit-billing-data?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=semantic&surface=html
Submit Invoice: https://vercel.com/docs/rest-api/marketplace/submit-invoice?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=semantic&surface=html
SvelteKit: /docs/frameworks/full-stack/sveltekit
Tanstack Start: /docs/frameworks/full-stack/tanstack-start
Templates: /templates
Terms of Service: /legal/terms
Toolbar: /docs/vercel-toolbar
Trust Center: https://security.vercel.com
Turborepo: /solutions/turborepo
Vercel + AWS: /partners/aws
Vercel Agent: /agent
Vercel Agent: /docs/agent
Vercel Documentation Sitemap: https://vercel.com/docs/sitemap.md?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=inbound&surface=html
Vercel Drop New: /drop
Vercel MCP: /docs/mcp
Vercel Plugin New: /plugin
Vercel REST API Reference: https://vercel.com/docs/rest-api?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=inbound&surface=html
Vercel REST API Reference: https://vercel.com/docs/rest-api?from=graph&source_path=%2Fdocs%2Frest-api%2Fbilling%2Fpurchase-credits&source_site=vercel-docs&relationship=outbound&surface=html
Vercel REST API: /docs
Vercel REST API: /docs/rest-api
Vercel SDK: /docs/rest-api/sdk
WAF: /security/web-application-firewall
Web Apps: /for/web-apps
Workflow SDK New: /workflows
Workflow: /docs/workflows
Workflows: /workflows
X: https://x.com/vercel
YouTube: https://youtube.com/@VercelHQ
eve New: /eve
eve New: https://eve.dev/
https://vercel.com/docs/graph.json: https://vercel.com/docs/graph.json
v0 ↗: https://v0.app
v0: https://v0.app

[structured-data]
{"@context":"https://schema.org","@type":"WebSite","name":"Vercel Documentation","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://lishhsx6kmthaacj.public.blob.vercel-storage.com/vercel-wordmark.svg"},"name":"Vercel Inc.","sameAs":["https://x.com/vercel","https://github.com/vercel/vercel","https://www.linkedin.com/company/vercel/","https://bsky.app/profile/vercel.com"],"url":"https://vercel.com/"},"url":"https://vercel.com/docs"}

[content]
Purchase credits | Vercel REST API
Skip to content
Copy Wordmark
Copy Logo
Download Brand Assets
Brand Guidelines
Docs
Build
Build with AI
AI Gateway
AI SDK
Sandbox
Container Registry
Workflow
Vercel Agent
v0
↗
Vercel MCP
AI Integrations
Deploy & scale
Deployments
CLI
Functions
Delivery Network
Storage
Integrations
Microfrontends
Domains
Operate & protect
Firewall
Observability
Feature Flags
Toolbar
Bot Management
BotID
Deployment Protection
Compliance
Learn
Resources
Changelog
↗
Blog
↗
Community
↗
Knowledge Base
APIs & SDKs
Templates
Getting Started
Ask AI
Log In
Sign Up
Build
Build with AI
AI Gateway
AI SDK
Sandbox
Container Registry
Workflow
Vercel Agent
v0
↗
Vercel MCP
AI Integrations
Deploy & scale
Deployments
CLI
Functions
Delivery Network
Storage
Integrations
Microfrontends
Domains
Operate & protect
Firewall
Observability
Feature Flags
Toolbar
Bot Management
BotID
Deployment Protection
Compliance
Learn
Resources
Changelog
↗
Blog
↗
Community
↗
Knowledge Base
APIs & SDKs
Templates
Getting Started
Ask AI
Sign Up
Log In
Vercel REST API
Overview
Getting Started
Errors
Access Groups
Ai Gateway
Aliases
API Ai Gateway
Artifacts
Authentication
Billing
GET
List FOCUS Billing Charges
GET
List FOCUS Contract Commitments
POST
Purchase Credits
Bulk Redirects
Certs
Checks V2
Connect
Deployments
DNS
Domains
Domains Registrar
Drains
Edge Cache
Environment
Feature Flags
Global Config
Integrations
Kms
Logs
Marketplace
Microfrontends
Networking
Observability
Project Routes
Projectmembers
Projects
Rolling Release
Sandboxes
Security
Static Ips
Storage
Teams
User
VCR
Web Analytics
Webhooks
APIs & SDKs
Vercel REST API
Purchase credits
Purchase credits
POST
https://api.vercel.com/v1/billing/buy
Purchases credits for a Vercel team using the default payment method on file. The purchase is charged immediately via Stripe invoice. Supported credit types are
v0
,
gateway
, and
agent
. The
amount
field specifies the number of credits to purchase and must be a positive integer. An optional
source
query parameter can be provided to identify the caller. Defaults to
api
if not specified. This is only available for Owner, Member, Developer, Security, and Billing roles for the supplied team.
Request
1
curl
--request
POST
\
2
--url
'https://api.vercel.com/v1/billing/buy?teamId=<team>'
\
3
--header
'Authorization: Bearer <token>'
\
4
--header
'Content-Type: application/json'
\
5
--data
'{"item":{"type":"credits","creditType":"v0","amount":100}}'
6
Response
1
{
2
"checkoutSessionId"
:
"example_id"
,
3
"checkoutSessionUrl"
:
"https://example.com"
4
}
Authentication
Authorization
bearerToken
Default authentication mechanism
Query parameters
source
string
Optional
The source of the purchase request. Defaults to
api
if not specified.
teamId
string
Optional
The Team identifier to perform the request on behalf of.
slug
string
Optional
The Team slug to perform the request on behalf of.
Body
application/json
item
object
Required
+
Show
3
properties
Response
200
Success
Variant 1
Variant 2
Variant 3
checkoutSessionId
string
Required
checkoutSessionUrl
string
Required
Errors
400
One of the provided values in the request query is invalid.
401
The request is not authorized.
402
Error
403
You do not have permission to access this resource.
404
Error
409
Error
410
Error
500
Error
Related Vercel documentation
Request
1
curl
--request
POST
\
2
--url
'https://api.vercel.com/v1/billing/buy?teamId=<team>'
\
3
--header
'Authorization: Bearer <token>'
\
4
--header
'Content-Type: application/json'
\
5
--data
'{"item":{"type":"credits","creditType":"v0","amount":100}}'
6
Response
1
{
2
"checkoutSessionId"
:
"example_id"
,
3
"checkoutSessionUrl"
:
"https://example.com"
4
}
Copy as Markdown
Install Vercel Plugin
OpenAPI Specification
Give feedback
Ask AI about this page
Agent Stack
AI SDK
AI Gateway
Sandbox
Workflows
Connect
New
Passport
New
eve
New
Core Platform
CI/CD
Content Delivery
Fluid Compute
Observability
Security
Platform Security
WAF
Bot Management
BotID
Tools
Vercel Drop
New
Vercel Agent
Vercel Plugin
New
Agent Skills
Domains
v0
Frameworks
eve
New
Next.js
Nuxt
SvelteKit
Nitro
Turborepo
Tanstack Start
FastAPI
All frameworks
SDKs
Vercel SDK
Workflow SDK
New
Flags SDK
Chat SDK
New
Queues SDK
New
Streamdown
Build
AI Apps
Web Apps
Marketing Sites
Platforms
Commerce
Platform Engineers
Design Engineers
Learn
Docs
Blog
Changelog
Knowledge Base
Academy
Articles
Community
Is Agentic
Explore
Customers
Marketplace
Templates
Partner Finder
Vercel + AWS
Company
About
Careers
Press
Events
Startups
Shipped on Vercel
Open Source Program
Enterprise
Pricing
Help
Legal & Trust
Privacy Policy
Terms of Service
Cookie Policy
DPA
Acceptable Use Policy
Legal (all documents)
Trust Center
Status
Cookie Preferences
Social
GitHub
X
LinkedIn
YouTube
Instagram
Cross-link map: Purchase credits (/docs/rest-api/billing/purchase-credits)
From the Vercel docs graph (built 2026-09-05T06:45:33.488Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON:
https://vercel.com/docs/graph.json
Semantically closest pages
Get Invoice
— GET /v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId} — Get Invoice details and status for a g
List FOCUS billing charges
— GET /v1/billing/charges — Returns the billing charge data in FOCUS v1.3 JSONL format for a specified Vercel team, within
Submit Billing Data
— POST /v1/installations/{integrationConfigurationId}/billing — Sends the billing and usage data. The partner should do th
Submit Invoice
— POST /v1/installations/{integrationConfigurationId}/billing/invoices — This endpoint allows the partner to submit an inv
Get rolling release billing status
— GET /v1/projects/{idOrName}/rolling-release/billing — Get the Rolling Releases billing status for a project. The team le
This page links to (1)
Vercel REST API Reference
— Interact programmatically with your Vercel account using the SDK or direct HTTP requests.
Pages that link here (2)
By site: vercel-docs (2)
Vercel REST API Reference
— Interact programmatically with your Vercel account using the SDK or direct HTTP requests.
Vercel Documentation Sitemap
— Browse Vercel documentation pages with summaries, prerequisites, and topics.
