API Utilities

Health check and timezone list

Health check and timezone utility endpoints.

Health Check

Check if the API is operational (no authentication required):

GET /v1/health/

Example

curl "https://api.missinglettr.com/v1/health/"

Response

{
  "status": "ok",
  "version": "1.0",
  "timestamp": "2025-01-15T14:30:00Z"
}

Monitoring: Use this endpoint for uptime monitoring and status checks. It's the only endpoint that doesn't require authentication.

List Timezones

Get all valid timezones for workspace configuration:

GET /v1/timezones/

Example

curl "https://api.missinglettr.com/v1/timezones/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "timezones": {
    "Americas": [
      "America/New_York",
      "America/Chicago",
      "America/Denver",
      "America/Los_Angeles",
      "America/Toronto",
      "America/Mexico_City"
    ],
    "Europe": [
      "Europe/London",
      "Europe/Paris",
      "Europe/Berlin",
      "Europe/Rome",
      "Europe/Madrid"
    ],
    "Asia": [
      "Asia/Tokyo",
      "Asia/Shanghai",
      "Asia/Hong_Kong",
      "Asia/Singapore",
      "Asia/Dubai"
    ],
    "Pacific": [
      "Pacific/Auckland",
      "Australia/Sydney",
      "Australia/Melbourne"
    ],
    "Africa": [
      "Africa/Cairo",
      "Africa/Johannesburg",
      "Africa/Lagos"
    ]
  }
}

When to Use Timezones Endpoint

Workspace Creation: Let users select from valid timezones
UI Dropdowns: Populate timezone selection dropdowns
Validation: Verify timezone strings before API calls

Format: All timezones follow IANA timezone database format (e.g., "America/New_York"). This ensures proper handling of daylight saving time.

Response Codes

Health check response codes:

200 OK: API is operational
503 Service Unavailable: API is down or under maintenance

Rate Limits Changelog