Utsavs Core API v1.0

Temporal data
with integrity.

The Utsavs API provides high-precision, story-aware holiday intelligence. Build with a deterministic engine that connects dates to culture.

Deterministic

Unlike AI guesses, our engine uses codified jurisdictional rules verified against primary source gazettes.

Story-Aware

Returns direct links to the Utsavs cultural library. Connect high-precision dates to their underlying human narratives.

Traceable

Every record exposes its source evidence and confidence score, providing a professional audit trail for compliance.

Developer Guide

Core API Reference

01. Authentication

Every request must include an X-API-KEY header. Access is restricted to authorized partners and can be managed in the Command Center.

02. Parameters

jurisdiction

Required. ISO 3166-1 alpha-2 country code (e.g., IN, JP, US).

date

Required. ISO-8601 date string (YYYY-MM-DD).

purpose

Optional. Context filter: travel, business, study, workforce, or logistics. Default: travel.

cURL Example
curl -X GET "https://utsavs.com/api/v1/intelligence" \
  -H "X-API-KEY: YOUR_KEY" \
  -G \
  --data-urlencode "jurisdiction=IN" \
  --data-urlencode "date=2026-11-08"

Rate Limiting

Standard Partner Tier: 5,000 requests per month. Enterprise tiers available for high-volume platforms.

No-Code Integration

The Widget Loader

Deploy the Utsavs experience on your site with a single script tag. The loader handles secure authentication, cross-domain iframes, and responsive layouts automatically.

Widget Customization

The loader supports two optional attributes for seamless white-label integration:

  • data-theme

    Set to light or dark. Default is dark.

  • data-color

    Any valid Hex color (e.g., #FF5733) to brand the primary elements.

Embed Snippet
<div id="utsavs-date-widget"></div> <script src="https://utsavs.com/api/v1/loader" data-key="YOUR_WIDGET_KEY" data-country="IN" data-theme="dark" data-color="#E8A33D" ></script>
UtsavsGLOBAL HOLIDAY INTELLIGENCE

The world's structured, verified holiday and observance intelligence engine. Built for technical systems and professional planning.

© 2026 UTSAVSGLOBAL DATA HUB
LIVE · DATA LAST REVIEWED 28 Oct 2026

Source-backed intelligence. Records carry a verification status and, where available, an authoritative source reference. Every record is reviewed against our deterministic logic baseline.

Lunar and government-declared dates are subject to change; Utsavs maintains the source and verification status for our comprehensive global database.