Solutions

Government

Public calendars that can withstand scrutiny

The problem

What is actually going wrong

Official holiday notifications and public event scheduling must be defensible. A date published by a department is expected to have a basis, and “the vendor’s software said so” is not one.

Our approach

Derive dates from versioned rules with named shastric authorities, and retain the trace so any published date can be reconstructed years later.

Workflow

How the integration runs

  1. Derive

    Generate the calendar for the relevant state or district.

  2. Cross-check

    Compare against that state’s own notified holiday list, which the API serves with the notification number, date and issuing authority.

  3. Record

    Store the rule id, version and trace alongside the notification.

  4. Publish

    Issue the calendar with its basis attached.

  5. Reproduce

    Any past notification can be regenerated exactly, on demand.

Integration

Endpoints and outcomes

Endpoints used

/v1/festivals/year/v1/festivals/explain/v1/calendar/year/v1/government-holidays/v1/government-holidays/sources

All of these are described in the OpenAPI 3.1 document, so you can generate a typed client rather than hand-writing request code.

What you get

  • Every published date reproducible from recorded rule versions
  • Named authorities rather than an opaque calculation
  • Regional variation handled through rule packs
  • Civil closures cited to the notification that declared them, with amendments kept rather than overwritten

Build it this week

The Free plan covers 500 requests a month, which is more than enough to prototype the workflow above.