Vercel Status Badge

Netlify-style deploy status badges for Vercel projects.

success badgebuilding badgequeued badgecanceled badgefailed badge

Usage

![Vercel Status](https://vercel-status.kirchnerundpartner.at/api/v1/badges/prj_XXXXXXXX/deploy-status)

The project id is in your Vercel project settings under General → Project ID. The project name works too.

Query parameters

ParameterDefaultDescription
branchLatest deployment of a git branch instead of production.
targetproductionproduction or preview. Only applied together with branch if set explicitly.
labelvercelText on the dark left segment.
teamIdTeam the project belongs to, if not configured server-side.

JSON

GET /api/v1/projects/:projectId/deploy-status

Same lookup, machine readable. Badge responses also carry the raw state in the x-vercel-deploy-state header.