# Vercel API

**Provider:** Vercel
**Category:** developer
**Base URL:** `https://api.vercel.com`
**Auth:** bearer — `Authorization: Bearer YOUR_VERCEL_TOKEN`
**Rate Limit:** 1,000 requests/hour per token
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://vercel.com/docs/rest-api

## Description

The Vercel REST API provides programmatic control over the entire Vercel platform. Create and inspect deployments, manage custom domains and SSL certificates, configure environment variables across projects, handle team members and permissions, retrieve build logs, set up webhooks, and manage edge functions. Ideal for custom CI/CD pipelines, infrastructure automation, and deployment dashboards.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.vercel.com/v6/deployments` | List deployments across all projects |
| POST | `https://api.vercel.com/v13/deployments` | Create a new deployment |
| GET | `https://api.vercel.com/v9/projects` | List projects in your account or team |
| GET | `https://api.vercel.com/v9/projects/{id}/env` | List environment variables for a project |
| POST | `https://api.vercel.com/v10/domains` | Add a custom domain to a project |
| GET | `https://api.vercel.com/v2/teams` | List teams accessible to your token |

## Authentication

Generate a Personal Access Token in Vercel Account Settings → Tokens. Pass it as a Bearer token in the Authorization header.

```
Authorization: Bearer YOUR_VERCEL_TOKEN
```

## Sample Request

```bash
curl "https://api.vercel.com/v6/deployments?limit=5&state=READY" \
  -H "Authorization: Bearer $VERCEL_TOKEN"
```

## Sample Response

```json
{
  "deployments": [{
    "uid": "dpl_abc123",
    "name": "my-next-app",
    "url": "my-next-app-git-main.vercel.app",
    "state": "READY",
    "created": 1704067200000,
    "target": "production",
    "meta": { "githubCommitMessage": "Fix hero layout" }
  }]
}
```

## Pricing Details

Hobby (free): personal projects, 100GB bandwidth. Pro $20/mo: commercial use, 1TB bandwidth, more serverless function duration. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/vercel/) — CC BY 4.0*