Get cart | TTG Developer Portal

Returns the current state of a cart, including all line items and hold expiration times.

Authentication

X-TT-API-Keystring

API key for authentication. Pass as X-TT-API-Key header.

Key prefixes:

Production: sk_live_*
Test: sk_test_*

Example: X-TT-API-Key: sk_live_abc123

API key for authentication. Pass as X-TT-API-Key header. Key prefixes: - Production: sk_live_* - Test: sk_test_* Example: X-TT-API-Key: sk_live_abc123

Path parameters

cartIdstringRequired

Unique identifier of the cart.

Headers

Response

Cart details.

idstring

Cart ID

itemslist of objects

Items currently in the cart (held inventory). Does NOT include fees, protection, or credits - see receiptLines for those.

receiptLineslist of objects

Server-ordered display lines for receipt rendering. Iterate in sequence. Always includes SubtotalLine. Conditionally: FeeLine, VoucherLine, ProtectionLine.

totalobject

Total amount to be charged at checkout (locked at cart creation). This value is used for expectedTotal validation in POST /orders.

expiresAtdatetime

UTC timestamp when the cart hold expires and inventory is released. Clients should display a countdown timer and warn users before expiration.

protectionobject or null

Protection covering all items. Null if not added.

totalTaxesobject or null

DISCLOSURE ONLY - taxes already included in total. Omitted when not disclosed (e.g., UK market).

1	curl https://staging.todaytix.com/api/v3/carts/789 \
2	-H "X-Client-Platform: ios" \
3	-H "X-Client-Version: 3.1.0" \
4	-H "Accept-Language: es-ES, es;q=0.9, en;q=0.8" \
5	-H "X-Request-ID: req_abc123xyz" \
6	-H "X-TT-API-Key: <apiKey>"

1	{
2	"id": "123",
3	"items": [
4	{
5	"id": "001",
6	"event": {
7	"id": "456",
8	"name": "Hamilton"
9	},
10	"occurrence": {
11	"id": "789",
12	"startsAt": "2026-03-15T19:30:00-05:00"
13	},
14	"venue": {
15	"id": "ven_richard_rodgers",
16	"name": "Richard Rodgers Theatre",
17	"address": {
18	"line1": "226 W 46th St",
19	"city": "New York",
20	"country": "US",
21	"state": "NY",
22	"postalCode": "10036"
23	},
24	"timezone": "America/New_York"
25	},
26	"inventoryVariant": {
27	"id": "var-seat-orch-a-101",
28	"_type": "AssignedSeat",
29	"attributes": [
30	{
31	"category": "NEGATIVE",
32	"name": "Limited Legroom"
33	}
34	],
35	"name": "Orchestra A 101",
36	"section": "Orchestra",
37	"row": "A",
38	"seat": "101"
39	},
40	"priceOption": {
41	"id": "po-adult",
42	"category": {
43	"name": "Adult"
44	},
45	"sellPrice": {
46	"amount": 18500,
47	"currency": "USD"
48	},
49	"listPrice": {
50	"amount": 15000,
51	"currency": "USD"
52	},
53	"totalFees": {
54	"amount": 2000,
55	"currency": "USD"
56	}
57	},
58	"quantity": 1
59	}
60	],
61	"receiptLines": [
62	{
63	"_type": "SubtotalLine",
64	"label": "Subtotal",
65	"total": {
66	"amount": 15000,
67	"currency": "USD"
68	},
69	"sign": "positive"
70	},
71	{
72	"_type": "FeeLine",
73	"label": "Booking Fee",
74	"total": {
75	"amount": 2000,
76	"currency": "USD"
77	},
78	"sign": "positive",
79	"id": "fee-order",
80	"kind": "OrderFee"
81	}
82	],
83	"total": {
84	"amount": 18500,
85	"currency": "USD"
86	},
87	"expiresAt": "2026-03-15T19:40:00Z",
88	"totalTaxes": {
89	"amount": 1500,
90	"currency": "USD"
91	}
92	}

Authentication

Path parameters

Headers

Response

Errors