ChronoShield API
v1.2 — Production Ready

Never ship a
timezone bug again.

One API to validate, resolve, and convert datetimes across every IANA timezone — with explicit handling of DST gaps, overlaps, and ambiguity. Half-hour offsets, 45-minute offsets, 30-minute DST shifts (e.g. Nepal, Lord Howe) — all covered.

Get Free API Key No credit card required
See Examples

Not needed for simple UTC display formatting. Built for apps that interpret and act on user-entered local times.

Timezone bugs are silent and expensive

Every timezone library can convert times. None of them tell you when a local time doesn't exist or happens twice. That's where the bugs hide.

DST Gap

User books a meeting at 2:30 AM on spring-forward day. That time doesn't exist. Most libraries silently shift it to 3:30 AM. Your app stores it with no warning.

Missed standups. No-show clients. Support tickets you can't explain.

DST Overlap

User picks 1:30 AM on fall-back day. That time happens twice. Your app silently picks one.

Double charges. Duplicate jobs. An incident at 2 AM you won't enjoy debugging.

Silent Offset

Naive UTC conversion picks -05:00 when it should be -04:00. No error. Just wrong.

Every scheduled task off by one hour, twice a year. No error. No alert. Just wrong.

ChronoShield API catches what others miss

Four endpoints. Explicit handling. Zero ambiguity.

Validate

Is this time valid, invalid (DST gap), or ambiguous (DST overlap)? Get an explicit answer with suggested fixes.

Resolve

Get a deterministic UTC instant from any local time. You choose the policy: earlier, later, or reject.

Convert

UTC to local, any timezone. Always unambiguous, always correct. Sub-50ms p95 latency.

Batch

Validate, resolve, or convert up to 100 datetimes in a single request. Partial failures handled per-item.

Where do I start?

validate "I have a user-entered local time. Is it safe to store?"
resolve "I need one deterministic UTC instant from this local time."
convert "I already have UTC. What's the local time in this timezone?"
batch "I need to validate, resolve, or convert many times in one call."

Built for systems where time matters

If your app schedules, bills, or automates anything across timezones, you need this.

📅

Scheduling & Calendar Apps

Prevent "phantom meetings" that fire at the wrong hour during DST transitions.

Cron & Workflow Automation

Jobs that must run exactly once, even when clocks spring forward or fall back.

💰

Billing & Payment Systems

Charges processed at the right time, not an hour early because of a silent offset error.

🤖

AI Agents & Copilots

Give your agent a tool that validates times before booking. Ships with function-calling schemas.

Integrate in under 5 minutes

One API key. One HTTP call. Instant value.

1 Install SDK 2 Create client 3 Validate a risky time
$ npm install chronoshield  # coming soon
TypeScript — minimal example
import { ChronoShieldClient } from "chronoshield";
const cg = new ChronoShieldClient({ apiKey: "YOUR_KEY" });

const result = await cg.validate({
  local_datetime: "2026-03-08T02:30:00",
  time_zone: "America/New_York",
});
// result.status === "invalid", reason_code === "DST_GAP"
TypeScript & Python SDKs OpenAPI 3.1 spec AI agent tool schemas

See it in action

Four endpoints. Zero ambiguity.

Try it live in the API Playground →

Request
$ curl -X POST https://chronoshieldapi.com/v1/datetime/validate \
  -H "x-api-key: YOUR_KEY" \
  -d '{
    "local_datetime": "2026-03-08T02:30:00",
    "time_zone": "America/New_York"
  }'
Response status: invalid
{
  "status": "invalid",
  "reason_code": "DST_GAP",
  "message": "This time does not exist due to DST transition.",
  "suggested_fixes": [
    { "strategy": "next_valid_time", "local_datetime": "2026-03-08T03:00:00" }
  ]
}

Production infrastructure, not a wrapper

ChronoShield API isn't a thin layer over a timezone library. It's correctness infrastructure with the operational maturity to match.

All
IANA timezones
Every offset, every DST regime. No hardcoded whitelist.
63
tests passing
Lord Howe, Chatham, Nepal, Samoa, Tehran, Casablanca, Fiji, Santiago & more
<50ms
p95 latency
Pure computation, no external I/O in the request path
v1.2
versioned API
X-API-Version header on every response. Changelog
persistent storage
PostgreSQL-backed keys & usage. Live status
Open source on GitHub Self-hostable via Docker OpenAPI 3.1 spec TypeScript & Python SDKs AI agent tool schemas

Simple, transparent pricing

Start free. Upgrade when you need to. Scale with annual enterprise plans.

One DST incident costs more than a year of Pro. Most timezone bugs cost hours of debugging — ChronoShield API prevents them for pennies per request.

Free

$0 /month

Prove it works. No credit card required.

  • 1,000 requests / month
  • All endpoints + batch
  • Community support

Perfect for prototyping and validating the integration.

Popular

Pro

$19 /month ($228/yr)

Self-serve production. Never debug a DST incident again.

  • 100,000 requests / month
  • Batch up to 100 ops in one call
  • Keys survive redeploys — PostgreSQL-backed
  • Usage dashboard & priority support

Best for scheduling, booking, billing, and workflow apps that accept user-entered times.

Enterprise

Procurement-ready production. Annual contracts with committed usage and the operational guarantees your team needs.

Move to Enterprise when you need annual billing, procurement support, SLAs, or higher annual volume.

Starter

$250 /month, billed annually

Best for one team that needs annual billing, SLAs, and headroom to grow.

  • 5M requests / year included
  • Overages at $0.08 / 1k requests
  • Invoice billing & annual contract
  • Priority email support (48h SLA)
Contact Sales
Best Value

Growth

$800 /month, billed annually

Best for multi-product or high-volume SaaS with scheduling, billing, or automation.

  • 10M requests / year included
  • Overages at $0.06 / 1k requests
  • Custom rate limits & burst capacity
  • Named support contact (24h SLA)
  • Security questionnaire & usage reporting
Contact Sales

Strategic

Custom

For large platforms, regulated industries, and high-stakes workflows.

  • Custom volume & negotiated pricing
  • Dedicated environment or self-hosting
  • Architecture & integration review
  • Procurement & legal support
  • Private Slack channel & onboarding
Contact Sales

All enterprise plans include: annual contract • invoice billing • PostgreSQL-backed persistence • batch support • declining overage rates at volume

Dig deeper

Everything you need to evaluate, integrate, and ship with confidence.

Versioned API behavior. Breaking changes announced in the changelog before they ship.

API Documentation

Endpoints, parameters, error codes, and SDK quickstart guides.

API Playground

Try every endpoint live in the browser. No setup required.

Live Status

Uptime, database health, and version info — updated in real time.

Changelog

Every feature, fix, and improvement. Versioned and dated.