Public Holidays API in cURL
Complete cURL integration guide for the Public Holidays API. Copy the code below, add your RapidAPI key, and start building.
Prerequisites
- 1.Sign up for a free account on RapidAPI
- 2.Subscribe to the Public Holidays API (free tier available)
- 3.Copy your
X-RapidAPI-Keyfrom the dashboard
Complete cURL Example
curl -X GET "https://public-holidays-by-helix-api.p.rapidapi.com/holidays?country=US&year=2026" \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: public-holidays-by-helix-api.p.rapidapi.com"Response Format
All Helix-API endpoints return a consistent JSON envelope:
{
"status": "ok",
"data": { ... },
"meta": {
"request_id": "req_abc123",
"latency_ms": 42
}
}On errors, status becomes "error" and a message field explains what went wrong.
Error Handling
| Status | Meaning | Action |
|---|---|---|
200 | Success | Parse the response body normally |
400 | Bad request | Check your request parameters |
401 | Unauthorized | Verify your X-RapidAPI-Key header |
429 | Rate limited | Wait and retry with exponential backoff |
500 | Server error | Retry after a short delay |
cURL Best Practices
Perfect for quick testing
cURL is the fastest way to test the Public Holidays API from your terminal. Copy the example above and replace YOUR_API_KEY.
Pipe output to jq
Add | jq '.' to pretty-print JSON responses, or | jq '.data' to extract specific fields.
Save to a file
Add -o response.json to save the output directly to a file. Great for logging and debugging.
Use environment variables for keys
Set export RAPIDAPI_KEY="your_key" and reference it with $RAPIDAPI_KEY in your curl commands. Never hardcode keys in scripts.
Public Holidays API Endpoints
/holidaysAll public holidays for a country and year
/nextUpcoming holidays for a country (next 365 days)
/countriesList all supported countries
Other Languages
View the Public Holidays API integration guide in another language: