Partner API — Ìbẹ̀rẹ̀ Kíákíá

Ìsopọ̀ àkọ́kọ́ rẹ yóò tó lórí ojú-ìwé kan.

Gbìyànjú rẹ̀ báyìí — kò sí kọ́kọ́rọ́, kò sí ìforúkọsílẹ̀

Ṣí àdírẹ́sì yìí nínú browser rẹ. Ìwọ yóò rí àwọn ìṣẹ̀lẹ̀ àpẹẹrẹ lẹ́sẹ̀kẹsẹ̀.

https://timtim.live/api/partner-network/demo?city=Washington

1
Gba kọ́kọ́rọ́ ìdánwò
Wọlé, sọ ẹni tí o jẹ́ fún wa, kí o sì tẹ Ṣẹ̀dá Kọ́kọ́rọ́ Ìdánwò. Ó bẹ̀rẹ̀ pẹ̀lú tt_test_, ó sì ń rí àwọn ìṣẹ̀lẹ̀ àpẹẹrẹ nìkan.

Wá àwọn ìṣẹ̀lẹ̀

Béèrè fún àwọn ìṣẹ̀lẹ̀ ní ìlú kan.

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

3
Fi ìṣẹ̀lẹ̀ náà hàn
Gbogbo ìṣẹ̀lẹ̀ ní orúkọ, ọjọ́, ibi, àwòrán, iye owó àti àwọn àkọlé tí a ti ṣètò fún káàdì rẹ.
4
Lo buy_url
Lo buy_url tí a fún ọ. Ìyẹn nìkan ni. TimTim.Live ń tọpa títà fún ọ nínú ìjápọ̀ náà.
5
Wo àwọn àbájáde
Wo àwọn ènìyàn tí o rán, àwọn tíkẹ́ẹ̀tì tí a tà àti owó tí o rí lórí pátákó rẹ, tàbí béèrè fún wọn.
GET https://api.timtim.live/v1/earnings

Gba Kọ́kọ́rọ́ Ìdánwò Mi Gbìyànjú Rẹ̀ Láìsí Kọ́kọ́rọ́

Ipò TimTim.Live

Ìtọ́kasí

Ibi tí o ti máa fi ìbéèrè ránṣẹ́

https://api.timtim.live/v1

Kọ́kọ́rọ́ Ìsopọ̀ Rẹ

Fi kọ́kọ́rọ́ rẹ ránṣẹ́ nínú àkọlé Authorization. Àwọn kọ́kọ́rọ́ ìdánwò (tt_test_) ń rí àwọn ìṣẹ̀lẹ̀ àpẹẹrẹ nìkan. Àwọn kọ́kọ́rọ́ ojú-òpó (tt_pk_live_) lè wà nínú ojú-ewé wẹ́ẹ̀bù, wọ́n sì ń ka àwọn ìṣẹ̀lẹ̀ nìkan. Àwọn kọ́kọ́rọ́ server (tt_sk_live_) ń dúró sórí server rẹ, wọ́n sì tún lè ka owó tí o rí. A máa ń fi kọ́kọ́rọ́ hàn lẹ́ẹ̀kan ṣoṣo — pa á mọ́ dáadáa.

curl

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

JavaScript

const res = await fetch("https://api.timtim.live/v1/events?city=Washington&category=music", {
  headers: { Authorization: "Bearer tt_test_YOUR_KEY" },
});
const { events, next } = await res.json();
for (const event of events) {
  console.log(event.name, event.display.date_label, event.tickets.buy_url);
}

Node

// Node 18+ — keep server keys (tt_sk_live_) on the server
const res = await fetch("https://api.timtim.live/v1/events?city=Washington", {
  headers: { Authorization: `Bearer ${process.env.TIMTIM_KEY}` },
});
if (!res.ok) {
  const problem = await res.json();
  throw new Error(`${problem.title} (${problem.request_id})`);
}
const { events } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.timtim.live/v1/events",
    params={"city": "Washington", "category": "music"},
    headers={"Authorization": f"Bearer {os.environ['TIMTIM_KEY']}"},
)
res.raise_for_status()
for event in res.json()["events"]:
    print(event["name"], event["tickets"]["buy_url"])

PHP

<?php
$ch = curl_init("https://api.timtim.live/v1/events?city=Washington&category=music");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . getenv("TIMTIM_KEY")]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
foreach ($data["events"] as $event) {
  echo $event["name"] . " " . $event["tickets"]["buy_url"] . PHP_EOL;
}

Àwọn Àlẹ̀mọ́

city: Àwọn ìṣẹ̀lẹ̀ ní ìlú yìí.
country: Kóòdù orílẹ̀-èdè oní-lẹ́tà méjì, fún àpẹẹrẹ US.
category: Fún àpẹẹrẹ music, festival tàbí conference.
from: Àwọn ìṣẹ̀lẹ̀ ní ọjọ́ yìí tàbí lẹ́yìn rẹ̀ (2026-10-20).
to: Àwọn ìṣẹ̀lẹ̀ ní ọjọ́ yìí tàbí ṣáájú rẹ̀.
changed_since: Àwọn ìṣẹ̀lẹ̀ tí ó yípadà lẹ́yìn àkókò yìí nìkan.
commissioned: true = àwọn ìṣẹ̀lẹ̀ tí ó ń san èrè nìkan.
minimum_earnings: Àwọn ìṣẹ̀lẹ̀ tí ó ń san ó kéré tán iye yìí fún tíkẹ́ẹ̀tì kọ̀ọ̀kan nìkan.
near: Ibì kan, fún àpẹẹrẹ near=Paris,FR.
limit: Iye ìṣẹ̀lẹ̀ fún ojú-ewé kọ̀ọ̀kan, 1 sí 100 (20 tí o kò bá fi sí i).

Sọ ohun tí ó yípadà nìkan fún mi

Fi àkókò ìmúdọ́gba rẹ tí ó kẹ́yìn pamọ́ kí o sì fi ránṣẹ́ gẹ́gẹ́ bí changed_since. Àwọn ìṣẹ̀lẹ̀ tí ó yípadà nìkan ni o máa gbà — títí kan àwọn tí a fagilé àti àwọn eré tí tíkẹ́ẹ̀tì wọn ti tán. O kò nílò webhook. Àwọn ìṣẹ̀lẹ̀ tí o gbọ́dọ̀ dáwọ́ fífihàn dúró ń wá nínú àkójọ withdrawn.

GET https://api.timtim.live/v1/events?changed_since=2026-10-06T10:00:00Z

Ju ojú-ewé kan lọ

Tí ìdáhùn bá ní next, fi í padà gẹ́gẹ́ bí cursor= láti gba ojú-ewé tó kàn. Nígbà tí next bá ṣófo, o ti gba gbogbo rẹ̀.

GET https://api.timtim.live/v1/events?city=Paris&cursor=eyJtIjoiZCIs…

Rírí owó

Gbogbo ìṣẹ̀lẹ̀ ní earn. Tí earn.eligible bá jẹ́ false, ìṣẹ̀lẹ̀ náà kò ní èrè — ó ṣì dára láti fi hàn. Tí ó bá jẹ́ true, earn.description sọ ohun tí o máa rí, fún àpẹẹrẹ "$5 fún tíkẹ́ẹ̀tì kọ̀ọ̀kan tí ó yẹ". Tí a bá dá owó ìrajà padà, a ó gba èrè náà padà.

Àwọn Feed Àkópọ̀ (ohun gbogbo nínú fáìlì kan)

Fi Feed Àkópọ̀ kan pamọ́ sórí pátákó rẹ, lẹ́yìn náà gba gbogbo ìṣẹ̀lẹ̀ tí ó bò sílẹ̀ nínú fáìlì kan tí a fún pọ̀: GET /v1/bulk/FEED_ID.ndjson.gz tàbí .csv.gz, pẹ̀lú kọ́kọ́rọ́ server rẹ. Ṣàfikún ?changed_since= fún ohun tí ó yí padà nìkan, pẹ̀lú àwọn ìṣẹ̀lẹ̀ tí a yọ kúrò. Àwọn kọ́kọ́rọ́ ìdánwò lè gbìyànjú rẹ̀ báyìí; lílò gidi nílò àyẹ̀wò láti ọ̀dọ̀ TimTim.Live.

GET https://api.timtim.live/v1/bulk/bfs_YOURFEED.ndjson.gz?changed_since=2026-10-06T00:00:00Z

Ta tíkẹ́ẹ̀tì nínú áàpù tìrẹ (ìṣòwò inú áàpù)

Àwọn alábàáṣiṣẹ́pọ̀ ńlá lè mú àwọn olùrà dúró nínú áàpù tiwọn. Béèrè GET /v1/events/EVENT_ID/tickets láti rí ohun tí ó wà fún títà, lẹ́yìn náà fi POST /v1/orders ránṣẹ́ pẹ̀lú àṣàyàn olùrà. O máa gba ìjápọ̀ ìsanwó TimTim.Live láti ṣí fún olùrà; a máa ka títà náà sí ilé-iṣẹ́ rẹ tààrà. Àwọn kọ́kọ́rọ́ ìdánwò lè gbìyànjú rẹ̀ báyìí. Lílò gidi nílò àyẹ̀wò TimTim.Live àti ìsanwó káàdì tí a ti tàn.

POST https://api.timtim.live/v1/orders  (Idempotency-Key: …)  {"event_id": "evt_test_washington_konpa", "ticket_type_id": "tt_test_washington_konpa", "quantity": 2, "buyer_email": "…", "buyer_name": "…"}

Àwọn ìfilọ̀ tí a so mọ́ káàdì (àwọn báǹkì àti ètò èrè)

GET /v1/offers ń fún ni ní gbogbo ìṣẹ̀lẹ̀ tí ó ń san èrè bí ìfilọ̀ kan: olùṣètò, àwọn ọjọ́ tí o lè rà, iye owó, ibi àti èrè. Oníbàárà rẹ ń mú un ṣiṣẹ́ nípasẹ̀ ìjápọ̀ rẹ tí a ń tọpa, a sì ń san èrè náà fún ilé-iṣẹ́ rẹ nípasẹ̀ /v1/earnings. Àwọn kọ́kọ́rọ́ ìdánwò ń rí àwọn ìfilọ̀ àpẹẹrẹ. Àwọn ìfilọ̀ gidi nílò àyẹ̀wò láti ọ̀dọ̀ TimTim.Live. Láti so ìsanwó káàdì pọ̀ tààrà nílò àdéhùn pẹ̀lú nẹ́tíwọ̀ọ̀kì káàdì tàbí báǹkì, a kò sì tíì so ó pọ̀.

GET https://api.timtim.live/v1/offers?country=US

Ipò ìṣẹ̀lẹ̀ àti àwọn tíkẹ́ẹ̀tì

status jẹ́ scheduled, postponed, rescheduled, cancelled, sold_out tàbí completed. tickets.availability jẹ́ available, limited, sold_out, not_on_sale tàbí ended. Nígbà tí ìṣẹ̀lẹ̀ bá di cancelled, yọ ọ́ kúrò.

GET https://api.timtim.live/v1/events/evt_test_washington_konpa

Bí o ṣe lè béèrè kíákíá tó

Àwọn kọ́kọ́rọ́ ìdánwò: ìbéèrè 60 ní ìṣẹ́jú kan. Àwọn kọ́kọ́rọ́ gidi: 120 ní ìṣẹ́jú kan. Tí o bá yára jù bẹ́ẹ̀ lọ, o máa gba ìdáhùn 429 pẹ̀lú Retry-After, iye ìṣẹ́jú-àáyá tí o máa dúró.

Àwọn ìṣẹ̀lẹ̀ wo ni o máa gbà

Àwọn ìṣẹ̀lẹ̀ tí àwọn olùṣètò TimTim.Live ṣẹ̀dá tí wọ́n sì yàn láti pín. A kì í fi àwọn ìṣẹ̀lẹ̀ tí a mú wá láti àwọn ojú-òpó tíkẹ́ẹ̀tì míì kún un rárá, nítorí a kò ní ẹ̀tọ́ láti pín wọn.

Ohun tí a kì í fi ránṣẹ́ rárá

Orúkọ àwọn olùrà, àdírẹ́sì ímeèlì, àdírẹ́sì ilé, nọ́ńbà fóònù àti àwọn àlàyé káàdì. Partner API ń pín ìròyìn ìṣẹ̀lẹ̀, kì í ṣe àwọn ọmọ ẹgbẹ́ wa.

Widget ojú-òpó

Ìlà HTML kan ń fi àwọn ìṣẹ̀lẹ̀ hàn lórí ojú-òpó èyíkéyìí. Lo kọ́kọ́rọ́ ojú-òpó (tt_pk_live_), kí o sì fi ojú-òpó rẹ kún àkójọ àwọn ojú-òpó tí kọ́kọ́rọ́ náà gbà láàyè. Láìsí kọ́kọ́rọ́, ó ń fi àwọn ìṣẹ̀lẹ̀ àpẹẹrẹ hàn.

<script src="https://timtim.live/widget/events.js"
        data-key="tt_pk_live_YOUR_WEBSITE_KEY"
        data-city="Washington" data-category="music" async></script>

Àwọn àṣàyàn: data-city, data-country, data-category, data-limit (1–24), data-earn="true", data-lang àti data-color.

OAuth 2.0 (àwọn ìsopọ̀ ńlá)

Kò pọn dandan. Ṣẹ̀dá client OAuth lórí pátákó rẹ, lẹ́yìn náà fi client ID àti secret rẹ̀ gba access token wákàtí kan, kí o sì fi token náà ránṣẹ́ dípò kọ́kọ́rọ́. Secret kò ní bá àwọn ìpè API rẹ lọ láéláé, o sì lè béèrè fún àṣẹ (scopes) tí ó kéré ju ti client náà lọ.

# 1. Trade the client ID and secret for a one-hour token
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials -d "scope=events:read events:details" \
  https://api.timtim.live/v1/oauth/token
# → {"access_token":"tt_at_…","token_type":"Bearer","expires_in":3600,"scope":"events:read events:details"}

# 2. Use the token exactly like a key
curl -H "Authorization: Bearer $ACCESS_TOKEN" "https://api.timtim.live/v1/events?city=Washington"

Láti parí token ṣáájú àkókò, fi ránṣẹ́ pẹ̀lú POST sí /v1/oauth/revoke pẹ̀lú client ID àti secret kan náà. Pípa client náà lórí pátákó rẹ máa parí gbogbo token rẹ̀ lẹ́ẹ̀kan náà.

Tì kọ́kọ́rọ́ mọ́ server rẹ

Kò pọn dandan. Lórí pátákó rẹ, ṣí "Tì í mọ́ server mi" lábẹ́ kọ́kọ́rọ́ server, kọ́kọ́rọ́ ìdánwò tàbí client OAuth, kí o sì kọ àwọn àdírẹ́sì gbangba ti server rẹ. Àwọn ìpè — àti àwọn ìbéèrè token — láti ibikíbi mìíràn ni a ó kọ̀ pẹ̀lú ip_not_allowed, kódà pẹ̀lú kọ́kọ́rọ́ tó tọ́.

Àwọn ìwé-ẹ̀rí client (mTLS): so ìwé-ẹ̀rí client TLS rẹ mọ́ kọ́kọ́rọ́ kan, lẹ́yìn náà pe https://api.timtim.live pẹ̀lú rẹ̀. Gbogbo ìpè gbọ́dọ̀ fi ìwé-ẹ̀rí yẹn hàn; ìfọwọ́kanra TLS fi hàn pé ìwọ ló ní kọ́kọ́rọ́ àdáni rẹ̀.

# Your certificate's SHA-256 — paste this (or the PEM) under "Lock to my servers"
openssl x509 -in client.crt -noout -fingerprint -sha256

# Every call then presents the certificate
curl --cert client.crt --key client.key \
  -H "Authorization: Bearer $KEY" "https://api.timtim.live/v1/events?city=Washington"

Plugin WordPress

Ṣé o ń lo WordPress? Fi TimTim.Live Events sílẹ̀: block àti shortcode tí ń fi àwọn ìṣẹ̀lẹ̀ hàn pẹ̀lú àwọn ìjápọ̀ tíkẹ́ẹ̀tì TimTim.Live tìrẹ. TimTim.Live ló ṣe é, ó ń bá timtim.live nìkan sọ̀rọ̀, ó sì ń ṣe àtúnṣe láti timtim.live nìkan.

Gbé fáìlì náà sókè ní Plugins → Add New → Upload Plugin. Lẹ kọ́kọ́rọ́ ojú-òpó rẹ sí Settings → TimTim.Live Events, kí o sì tẹ Test Connection. Lẹ́yìn náà, fi block TimTim.Live Events kún ojú-ewé èyíkéyìí.

Ṣe ìgbàsílẹ̀ Plugin WordPress

[timtim_events city="Washington" category="music" limit="6"]

Àwọn feed

Àwọn ìṣẹ̀lẹ̀ kan náà gẹ́gẹ́ bí JSON Feed, RSS, XML, CSV tàbí kàlẹ́ńdà (.ics) tí Google Calendar, Apple Calendar àti Outlook lè forúkọ sílẹ̀ fún. Àwọn olùka feed kò lè fi àkọlé ránṣẹ́, nítorí náà fi kọ́kọ́rọ́ ojú-òpó tàbí kọ́kọ́rọ́ ìdánwò sínú ?key=. Má ṣe fi kọ́kọ́rọ́ server sínú ìjápọ̀ láéláé.

https://timtim.live/v1/feeds/events.json?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.rss?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.xml?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.csv?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.ics?key=tt_pk_live_YOUR_KEY&city=Paris

Webhooks

Fi àdírẹ́sì kan kún un lórí pátákó rẹ, a ó sì fi ìránṣẹ́ ránṣẹ́ sí i nígbà tí nǹkan bá yí padà: event.changed tàbí earnings.changed. Webhooks kì í ṣe dandan — changed_since ń fún ọ ní ìsọfúnni kan náà.

{
  "id": "whd_8Fk2mQxR7tLp",
  "type": "event.changed",
  "created_at": "2026-10-06T15:04:05.000Z",
  "mode": "live",
  "data": {
    "event": {
      "id": "ev_…",
      "name": "…",
      "status": "cancelled",
      "tickets": {
        "availability": "ended",
        "buy_url": "https://timtim.live/b/…"
      },
      "…": "the same event object as GET /v1/events"
    }
  }
}

Ṣàyẹ̀wò ìránṣẹ́ kọ̀ọ̀kan: a fi àṣírí rẹ buwọ́lù ú. Kọ ohunkóhun tí ó ti ju ìṣẹ́jú márùn-ún lọ, kí o sì fojú fo TimTim-Delivery-Id tí o ti bójú tó tẹ́lẹ̀.

// Node — Express with the RAW body (do not JSON.parse before checking)
import crypto from "node:crypto";

app.post("/timtim", express.raw({ type: "application/json" }), (req, res) => {
  const header = req.get("TimTim-Signature") ?? "";           // t=1700000000,v1=<hex>
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const body = req.body.toString("utf8");
  const expected = crypto.createHmac("sha256", process.env.TIMTIM_WEBHOOK_SECRET)
    .update(`${parts.t}.${body}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) <= 300;
  const same = expected.length === (parts.v1 ?? "").length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
  if (!fresh || !same) return res.sendStatus(400);

  const message = JSON.parse(body);                            // { id, type, mode, data }
  if (alreadyHandled(req.get("TimTim-Delivery-Id"))) return res.sendStatus(200);
  // message.type === "event.changed"    → message.data.event
  // message.type === "earnings.changed" → message.data.earning
  res.sendStatus(200);
});

Dáhùn pẹ̀lú 2xx èyíkéyìí láàárín ìṣẹ́jú-àáyá 10. Bí bẹ́ẹ̀ kọ́, a ó tún gbìyànjú lẹ́yìn ìṣẹ́jú 1, ìṣẹ́jú 5, ìṣẹ́jú 30, lẹ́yìn náà wákàtí 2, 6, 12 àti 24, lẹ́yìn náà a ó dúró. A kì í tẹ̀lé àtúndarí láéláé.

Ibi ìdánwò

Àwọn kọ́kọ́rọ́ ìdánwò ń gba àwọn ìṣẹ̀lẹ̀ àpẹẹrẹ tí a sàmì sí ÌṢẸ̀LẸ̀ ÌDÁNWÒ — KÒ SÍ OWÓ GIDI. Ṣí buy_url kan, tẹ Ra Tíkẹ́ẹ̀tì Ìdánwò, lẹ́yìn náà béèrè fún owó tí o rí. Ṣe àdánwò ìdápadà owó kí o sì wò ó bí a ṣe gbà á padà.

Nígbà tí nǹkan bá bàjẹ́

Àwọn àṣìṣe ń ṣàlàyé ara wọn ní ọ̀rọ̀ tí ó rọrùn, pẹ̀lú àkọlé àti ohun tí o lè ṣe tó kàn. Gbogbo ìdáhùn ní TimTim-Request-Id. Fi ránṣẹ́ sí wa, a ó sì rí ìbéèrè rẹ.

401missing_keyPlease add your TimTim.Live key. Send it as: Authorization: Bearer tt_test_… — get a test key at /partners/dashboard.
401invalid_keyWe do not recognise that key. Check you copied the whole key, or make a new one at /partners/dashboard.
401revoked_keyThat key was switched off. Make a new key at /partners/dashboard.
403partner_inactiveThis partner account cannot use live keys right now. Your test key still works. Contact TimTim.Live partnerships to review the account.
403missing_scopeThis key is not allowed to do that. Earnings need a secret key (tt_sk_live_…) or a test key, used from your server.
403domain_not_allowedThis website is not allowed to use this key. Add the website to the key's allowed domains at /partners/dashboard.
400unknown_parameterWe do not know one of those parameters. See /partners/docs for the list.
400invalid_countryWe could not read that country. Use a two-letter code, for example country=US or country=FR.
400invalid_dateWe could not read that date. Dates look like 2026-10-20.
400invalid_changed_sinceWe could not read changed_since. Use a full time, for example changed_since=2026-10-06T10:00:00Z.
400invalid_booleanThat value must be true or false. For example commissioned=true.
400invalid_numberThat value must be a number. For example minimum_earnings=5.
400invalid_nearWe could not find that place. Try near=Paris,FR or city=Paris&country=FR.
400invalid_locationWe could not read that location. Send lat, lng and optionally radius in kilometres.
400invalid_limitlimit must be between 1 and 100. Leave it out to get 20.
400invalid_cursorThat cursor is not one we gave you. Use the `next` value from the previous page exactly as it came.
404event_not_foundWe could not find that event. It may have been removed, or it is not shared with partners.
403capability_requiredCard-linked offers are not switched on for your account. Offers are an enterprise feature. Your test key shows sample offers now; ask TimTim.Live partnerships to review your account for live offers.
403server_key_requiredThis is for your server only. Use a secret key (tt_sk_live_…) or a test key from your server, never a website key in a web page.
403commerce_not_enabledSelling tickets in your own app is not switched on for your account. This is an enterprise feature (EMBEDDED_CHECKOUT). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, use each event's buy_url.
503checkout_not_openCard payments are not open on TimTim.Live yet. Send the buyer to the event's buy_url instead. Your test key can still rehearse orders.
409ticket_not_availableThat ticket cannot be bought right now. It may be sold out, not on sale yet, or no longer on sale. Ask /v1/events/{id}/tickets for what is on sale now.
400order_invalidWe could not read that order. See /partners/docs for the fields an order needs.
400idempotency_key_requiredPlease send an Idempotency-Key header. 8 to 80 letters, digits, - or _. Send the same key again to retry safely — you will get the same order, never a second one.
404order_not_foundWe could not find that order. Only orders your company began with this kind of key (test or live) can be read here.
403bulk_not_enabledBulk feeds are not switched on for your account. This is an enterprise feature (BULK_FEEDS). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, page through /v1/events or the feeds.
404bulk_not_foundWe could not find that bulk feed. Use the address shown on /partners/dashboard: /v1/bulk/<subscription id>.ndjson.gz or .csv.gz.
429bulk_too_soonA full file was made for this feed a few minutes ago. Full files can be made every 15 minutes. For what changed since, add changed_since=<time> — that is not limited.
410event_withdrawnThis event is no longer shared with partners. Stop showing it and remove its buy_url. Nothing else is needed — your old link still takes people to the event page.
400invalid_trackWe could not read that tracking signal. Send {"type":"impression"}, {"type":"event_view","event_id":"…"} or {"type":"event_click","event_id":"…"}. Sales are recorded by TimTim.Live, never sent from a page.
404not_foundThere is nothing at this address. The Partner API lives at /v1/events, /v1/events/{id}, /v1/offers and /v1/earnings.
405method_not_allowedThis address does not answer that method. The Allow header lists the methods it answers.
401key_in_urlSend your key in the Authorization header. Only /v1/feeds reads a key from the URL (?key=). Everywhere else use Authorization: Bearer <key> — keys in URLs end up in logs.
403ip_not_allowedThis key only works from your listed servers. Call from an address on the key's allowlist, or change the list at /partners/dashboard.
401certificate_requiredThis key needs your client certificate. Connect to https://api.timtim.live with the TLS client certificate pinned to this key.
401certificate_mismatchThat is not the certificate pinned to this key. Use the certificate whose SHA-256 is on your dashboard, or pin the new one there.
429rate_limitedToo many requests — please slow down. Wait the number of seconds in Retry-After, then try again.
503unavailableThe Partner API is resting for a moment. Please try again in a minute.
500server_errorSomething went wrong on our side. Please try again. If it keeps happening, send us your TimTim Request ID.

Àdéhùn API

Àlàyé kíkún ti gbogbo pápá, ní ọ̀nà OpenAPI tí àwọn irinṣẹ́ rẹ lè kà.

Ṣe ìgbàsílẹ̀ openapi.yaml

Bí àwọn kọ́kọ́rọ́ gidi ṣe ń ṣí

Kọ́kọ́rọ́ ìdánwò rẹ ń ṣiṣẹ́ lẹ́sẹ̀kẹsẹ̀. Fún àwọn kọ́kọ́rọ́ gidi, ẹnìkan ní TimTim.Live yóò wo orúkọ ilé-iṣẹ́ rẹ, ojú-òpó wẹ́ẹ̀bù rẹ àti bí ìwọ yóò ṣe fi àwọn ìṣẹ̀lẹ̀ hàn. Ìwọ yóò rí ìdáhùn lórí pátákó rẹ.

Àwọn Ìmúdójúìwọ̀n API TimTim.Live

Ẹ̀dà 1 ń dàgbà nìkan. A ń fi àwọn nǹkan tuntun kún un. A kì í yọ ohun tí ó ti wà níbẹ̀ kúrò, a kì í sì yí orúkọ rẹ̀ padà.

2026-10-08 — Àwọn ìdáhùn nípa ìṣẹ̀lẹ̀ ní ETag báyìí. Fi í padà sínú If-None-Match láti gba 304 kíákíá nígbà tí kò sí ohun tó yí padà. Kò pọn dandan.
2026-10-08 — Àwọn kọ́kọ́rọ́ ojú-òpó wẹ́ẹ̀bù ń ka àlejò kọ̀ọ̀kan lọ́tọ̀ báyìí, kí àwọn ojú-òpó tí èrò pọ̀ sí lè máa ṣiṣẹ́ lọ. O kò nílò láti ṣe nǹkankan.
2026-10-07 — Àwọn ìwé-ẹ̀rí client (mTLS) ti ṣí: so ìwé-ẹ̀rí rẹ mọ́ kọ́kọ́rọ́ kan lórí pátákó rẹ. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-07 — Àwọn feed àkópọ̀: gbogbo ìṣẹ̀lẹ̀ tí o lè fi hàn, nínú fáìlì kan, ní GET /v1/bulk. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-07 — API ní àdírẹ́sì tirẹ̀ báyìí: https://api.timtim.live/v1. https://timtim.live/v1 ṣì ń ṣiṣẹ́. Kò sí ohun tí o nílò láti ṣe.
2026-10-06 — Ojú-ewé ìsanwó tìrẹ pẹ̀lú àmì-ìdámọ̀ rẹ ní timtim.live/checkout. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Ta tíkẹ́ẹ̀tì nínú áàpù tìrẹ: GET /v1/events/EVENT_ID/tickets àti POST /v1/orders. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Ojú-ewé ipò tí gbogbo ènìyàn lè rí ní /partners/status, tí a ń ṣàyẹ̀wò ní ìṣẹ́jú kọ̀ọ̀kan. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Àkọsílẹ̀ owó oṣooṣù fún àwọn ilé-iṣẹ́: GET /v1/settlements. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Postbacks: fi ?sub_id= kún ìjápọ̀ ìrà, a ó sì dá a padà sí ọ pẹ̀lú títà náà. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Àwọn ìfilọ̀ tí a so mọ́ káàdì fún àwọn báǹkì àti ètò èrè: GET /v1/offers. Kò pọn dandan. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Feed kàlẹ́ńdà: /v1/feeds/events.ics fún Google Calendar, Apple Calendar àti Outlook. O kò nílò láti ṣe nǹkan kan.
2026-10-06 — Tì kọ́kọ́rọ́ mọ́ server rẹ: àwọn àkójọ IP tí a gbà láàyè báyìí, àwọn ìwé-ẹ̀rí client (mTLS) lórí api.timtim.live. Kò pọn dandan. O kò nílò láti ṣe nǹkan kan.
2026-10-06 — OAuth 2.0 client credentials fún àwọn ìsopọ̀ ńlá: POST /v1/oauth/token àti /v1/oauth/revoke. Àwọn kọ́kọ́rọ́ ṣì ń ṣiṣẹ́. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Plugin WordPress 1.0.0: block kan, shortcode kan àti ojú-ewé ètò kan. Ó ń ṣe àtúnṣe ara rẹ̀ láti timtim.live. O kò nílò láti ṣe nǹkankan.
2026-10-06 — Widget ojú-òpó, àwọn feed JSON/RSS/XML/CSV àti webhooks (event.changed, earnings.changed). O kò nílò láti ṣe nǹkankan.
2026-10-06 — Partner API v1: àwọn ìṣẹ̀lẹ̀, ìṣẹ̀lẹ̀ kan, owó tí o rí, àti ibi ìdánwò. O kò nílò láti ṣe nǹkankan.