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.
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
jurisdictionRequired. ISO 3166-1 alpha-2 country code (e.g., IN, JP, US).
dateRequired. ISO-8601 date string (YYYY-MM-DD).
purposeOptional. Context filter: travel, business, study, workforce, or logistics. Default: travel.
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.
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-themeSet to
lightordark. Default is dark.data-colorAny valid Hex color (e.g.,
#FF5733) to brand the primary elements.