Indian Calendar Data
for Every Developer

All calendar API endpoints require an API key. Pass it via the X-API-Key header (recommended) or ?api_key= query parameter.

X-API-Key: tzc_live_your_api_key_here

Dashboard endpoints (key management, usage stats) additionally require a Bearer session token in the Authorization header, obtained from the login endpoint.

Three-step process: Register → Verify OTP → Receive API Key

POST /api/auth/register
Content-Type: application/json

{
  "full_name":    "Rahul Sharma",
  "email":        "rahul@example.com",
  "password":     "SecurePass123",
  "company_name": "My Startup Pvt Ltd",
  "phone":        "+91 98765 43210"
}

POST /api/auth/verify-otp
Content-Type: application/json

{
  "email":   "rahul@example.com",
  "otp":     "483920",
  "purpose": "register"
}

{
  "status":  "success",
  "data": {
    "api_key":        "tzc_live_a1b2c3d4...",  // SHOWN ONCE
    "key_prefix":     "tzc_live_a1b2",
    "session_token":  "eyJ0eXAiOiJKV1Qi...",
    "user": {
      "id": 42, "full_name": "Rahul Sharma"
    }
  }
}

Returns Indian holidays filtered by year, month, day, or holiday type.

Returns a full calendar month grid — every day with weekday, is_holiday, is_working flags, and embedded holiday details.

// Vanilla fetch — get June 2026 national holidays
const API_KEY = 'tzc_live_your_key_here';
const BASE    = 'https://api.tezzcorp.in';

async function getHolidays(year, month) {
  const url = `${BASE}/api/v1/holidays?country=IN&year=${year}&month=${month}`;
  const res = await fetch(url, {
    headers: { 'X-API-Key': API_KEY }
  });
  if (!res.ok) throw new Error('API error ' + res.status);
  return (await res.json()).data;
}

// jQuery AJAX example
$.ajax({
  url: BASE + '/api/v1/calendar',
  data: { country: 'IN', year: 2026, month: 6 },
  headers: { 'X-API-Key': API_KEY },
  success: function(r) { console.log(r.data.days); }
});

<?php
$apiKey = 'tzc_live_your_key_here';
$url    = 'https://api.tezzcorp.in/api/v1/holidays?country=IN&year=2026&month=6';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ' . $apiKey],
    CURLOPT_TIMEOUT        => 10,
]);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $holiday) {
    echo $holiday['date'] . ': ' . $holiday['name'] . PHP_EOL;
}

import requests

API_KEY = 'tzc_live_your_key_here'
BASE    = 'https://api.tezzcorp.in'

headers  = {'X-API-Key': API_KEY}
params   = {'country': 'IN', 'year': 2026, 'month': 6}

resp = requests.get(f'{BASE}/api/v1/holidays', headers=headers, params=params)
data = resp.json()

for h in data['data']:
    print(f"{h['date']} — {h['name']} ({h['holiday_type']})")

# List June 2026 holidays
curl -X GET "https://api.tezzcorp.in/api/v1/holidays?country=IN&year=2026&month=6" \
  -H "X-API-Key: tzc_live_your_key_here"

# Get full calendar grid
curl -X GET "https://api.tezzcorp.in/api/v1/calendar?country=IN&year=2026&month=6" \
  -H "X-API-Key: tzc_live_your_key_here"

# Register a new account
curl -X POST "https://api.tezzcorp.in/api/auth/register" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Rahul","email":"r@example.com","password":"Pass@123"}'

When you exceed a limit, the API returns HTTP 429 with a Retry-After header. Daily quotas reset at 00:00 UTC.