Authentication

API authentication and rate limits

Authentication

The API supports both free and premium access via API keys.

Premium API Keys

Premium members receive API keys with the dih_ prefix for enhanced access limits.

GET /api/today/
Authorization: Bearer dih_your_api_key_here

Free Access

No authentication required for basic access with standard rate limits.

GET /api/today/

Rate Limits

Different rate limits apply based on your access level:

Free users: 10 requests per hour
Premium members: 1,000 requests per hour

Rate limit headers are included in all responses:

X-RateLimit-Limit: Maximum requests allowed
X-RateLimit-Remaining: Requests remaining in current window
X-RateLimit-Reset: Time when limit resets

Premium Access

Refer to our Support page to learn more about how to get a premium API key for higher rate limits.

Introduction

REST API for historical events, births, and deaths

Historical Births by Date GET

Next Page