POST AI agent ready /v1/headers

HTTP Headers API - Inspect Response Headers for Any URL

Fetches a URL and returns all HTTP response headers. Useful for debugging proxies, CDNs, caching layers, and middleware configurations.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/headers \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

Debug CDN caching behavior

Inspect the Cache-Control, Age, and X-Cache headers returned by your CDN to verify that content is being cached as expected. Compare headers from different edge locations to confirm consistent caching rules.

Verify rate limit headers from third-party APIs

Before building retry logic for a third-party API integration, inspect their response headers to find rate limit fields (X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After). Use these values to calibrate your client-side throttling.

Audit CORS headers for cross-origin requests

Check Access-Control-Allow-Origin, Access-Control-Allow-Methods, and Access-Control-Allow-Headers to debug why a browser is blocking cross-origin requests from your frontend to a third-party API.

Frequently asked questions

Does this follow redirects?

Yes. The endpoint follows HTTP redirects and returns the headers from the final response.

What does the count field represent?

count is the total number of distinct headers returned in the response. It gives you a quick overview of how many headers the server sends.

Can I use this to check my own API headers?

Yes. Pass your API endpoint URL and inspect the returned headers to verify CORS, caching, security, and rate limiting configuration.

Are response bodies included?

No. This endpoint returns only the HTTP response headers, not the response body. This keeps the response small and focused on header inspection.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.