Getting Started | TTG Developer Portal

Welcome to the TTG API. This guide covers authentication, required headers, and core concepts.

Base URLs

Environment	URL
Production	`https://api.ttix.io`
Staging	`https://staging.todaytix.com`

All API requests require an API key in the X-TT-API-Key header.

$ X-TT-API-Key: sk_live_abc123

Key prefixes:

Prefix	Environment
`sk_live_*`	Production
`sk_test_*`	Staging / Test

Every request must include X-Client-Platform. Other headers are recommended for tracing and localization.

Header	Required	Description
`X-TT-API-Key`	Yes	Your API key (e.g. `sk_live_abc123`)
`X-Client-Platform`	Yes	One of: `ios`, `android`, `web`, `server`
`X-Client-Version`	Conditional	Semantic version (e.g. `3.1.0`). Required for `ios`, `android`, `web`.
`Accept-Language`	No	Language preference (e.g. `en-US`). Defaults to `en-US`.
`X-Request-ID`	No	Client-generated trace ID (format: `req_abc123xyz`). Echoed in response.

All monetary values use minor units (cents) to avoid floating-point precision errors.

Occurrence times (startsAt, endsAt) use the venue’s local timezone with ISO 8601 offset (e.g. 2026-03-15T19:30:00-05:00).
System timestamps (createdAt, expiresAt) use UTC (e.g. 2026-03-15T19:40:00Z).