Holiday API

Free access to global holiday data

Quick Links

Base URL


                                https://xubit.xyz/api/v1

Getting Started

Our API provides free access to holiday data from over 100 countries. No authentication is required for basic usage.

Quick Example:

GET https://xubit.xyz/api/v1/holidays?country=US&year=2025

Holidays Endpoint

GET /holidays

Retrieve holidays with optional filters.

Parameters

Parameter	Type	Description
`country`	string	ISO 3166-1 alpha-2 country code (e.g., US, GB, DE)
`year`	integer	Year (default: current year)
`month`	integer	Month (1-12)
`type`	string	Holiday type (Public, Religious, etc.)
`upcoming`	boolean	Only return future holidays
`limit`	integer	Results per page (max: 100, default: 50)
`offset`	integer	Pagination offset

Example Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "New Year's Day",
      "date": "2025-01-01",
      "day_of_week": "Wednesday",
      "type": "Public",
      "description": "First day of the new year",
      "country": {
        "code": "US",
        "name": "United States"
      }
    }
  ],
  "meta": {
    "total": 11,
    "limit": 50,
    "offset": 0,
    "has_more": false
  },
  "filters": {
    "year": 2025,
    "country": "US",
    "month": null,
    "type": null,
    "upcoming": false
  }
}

Countries Endpoint

GET /countries

List all available countries or get details for a specific country.

Parameters

Parameter	Type	Description
`code`	string	Get details for specific country code

Code Examples

JavaScript

fetch('https://xubit.xyz/api/v1/holidays?country=US&year=2025')
  .then(res => res.json())
  .then(data => console.log(data.data));

Python

import requests

response = requests.get('https://xubit.xyz/api/v1/holidays', 
    params={'country': 'US', 'year': 2025})
holidays = response.json()['data']

cURL

curl "https://xubit.xyz/api/v1/holidays?country=US&year=2025"

Rate Limits

Free Tier Limits

100 requests per minute per IP
Maximum 100 results per request
No authentication required