vercel httpstat

The vercel httpstat command works like httpstat, but automatically handles deployment protection bypass tokens for you. It provides visualization of HTTP timing statistics, showing how long each phase of an HTTP request takes. When your project has Deployment Protection enabled, this command lets you test protected deployments without manually managing bypass secrets.

The command runs the httpstat tool with the same arguments you provide, but adds an x-vercel-protection-bypass header with a valid token. This makes it simple to measure response times, analyze performance bottlenecks, or debug latency issues on protected deployments.

vercel httpstat [path]

Get timing statistics for your production deployment:

vercel httpstat /api/hello

Analyze timing for a POST request with JSON data:

vercel httpstat /api/users -X POST -H "Content-Type: application/json" -d '{"name":"John"}'

Test timing for a specific deployment by its URL:

vercel httpstat /api/status --deployment https://my-app-abc123.vercel.app

Run multiple requests to get average timing statistics:

vercel httpstat /api/data -n 10

When you run vercel httpstat:

1. The CLI finds your linked project (or you can specify one with --scope)
2. It gets the latest production deployment URL (or uses the deployment you specified)
3. It retrieves or generates a deployment protection bypass token
4. It runs the httpstat tool with the bypass token in the x-vercel-protection-bypass header
5. The tool displays a visual breakdown of request timing phases: DNS lookup, TCP connection, TLS handshake, server processing, and content transfer

The command requires httpstat to be installed on your system.

These are options that only apply to the vercel httpstat command.

The --deployment option, shorthand -d, lets you specify a deployment URL to request instead of using the production deployment.

vercel httpstat /api/hello --deployment https://my-app-abc123.vercel.app

The --protection-bypass option, shorthand -b, lets you provide your own deployment protection bypass secret instead of automatically generating one. This is useful when you already have a bypass secret configured.

vercel httpstat /api/hello --protection-bypass your-secret-here

You can also use the VERCEL_AUTOMATION_BYPASS_SECRET environment variable:

export VERCEL_AUTOMATION_BYPASS_SECRET=your-secret-here
vercel httpstat /api/hello

The httpstat tool displays timing information in a visual format:

• DNS Lookup: Time to resolve the domain name
• TCP Connection: Time to establish a TCP connection
• TLS Handshake: Time to complete the SSL/TLS handshake (for HTTPS)
• Server Processing: Time for the server to generate the response
• Content Transfer: Time to download the response body

Each phase is color-coded and displayed with its duration in milliseconds, helping you identify which part of the request is taking the most time.

Make sure httpstat is installed on your system:

# Install with pip (Python)
pip install httpstat
 
# Or install with Homebrew (macOS)
brew install httpstat

Make sure you're in a directory with a linked Vercel project and that the project has at least one deployment:

# Link your project
vercel link
 
# Deploy your project
vercel deploy

If automatic token creation fails, you can create a bypass secret manually in the Vercel Dashboard:

1. Go to your project's Settings → Deployment Protection
2. Find "Protection Bypass for Automation"
3. Click "Create" or "Generate" to create a new secret
4. Copy the generated secret
5. Use it with the --protection-bypass flag or VERCEL_AUTOMATION_BYPASS_SECRET environment variable

When using --deployment, verify that:

• The deployment ID or URL is correct
• The deployment belongs to your linked project
• The deployment hasn't been deleted

The following global options can be passed when using the vercel httpstat command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --scope
• --token

For more information on global options and their usage, refer to the options section.

• Deployment Protection
• vercel curl
• vercel deploy
• vercel inspect