Skip to main content

TempsReel API Quick Start

Get up and running with the TempsReel API in 5 minutes.

What is TempsReel API?​

The TempsReel API provides real-time access to Tick&Live's event management platform. It offers:

  • Real-time catalog access - Browse events, venues, and rates
  • Cart management - Add, modify, and remove items from shopping carts
  • Order processing - Book and confirm orders programmatically
  • Seat management - Allocate and manage seats for events

Prerequisites​

Step 1: Authenticate Your Request​

All API requests require the x-tenant header:

curl -X GET "http://tempsreel-pre.connect.tickandlive.com/api/v1/catalog/venues" \
  -H "x-tenant: your-tenant-id" \
  -H "Accept: application/json"

Step 2: Your First API Call - Browse Events​

Get a list of available events for a specific date range:

cURL​

curl -X GET "http://tempsreel-pre.connect.tickandlive.com/api/v1/catalog/events?dateFrom=2026-01-01&dateTo=2026-12-31" \
  -H "x-tenant: your-tenant-id" \
  -H "Accept: application/json"

C#​

using System.Net.Http;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-tenant", "your-tenant-id");
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync(
    "http://tempsreel-pre.connect.tickandlive.com/api/v1/catalog/events?dateFrom=2026-01-01&dateTo=2026-12-31"
);

var content = await response.Content.ReadAsStringAsync();
var events = JsonSerializer.Deserialize<EventsResponse>(content);

Python​

import requests

headers = {
    "x-tenant": "your-tenant-id",
    "Accept": "application/json"
}

response = requests.get(
    "http://tempsreel-pre.connect.tickandlive.com/api/v1/catalog/events",
    params={
        "dateFrom": "2026-01-01",
        "dateTo": "2026-12-31"
    },
    headers=headers
)

events = response.json()

Understanding the Response​

You'll receive a JSON response with event data:

{
  "events": [
    {
      "id": 12345,
      "name": "Concert Example",
      "venueId": 789,
      "startDate": "2026-01-15T20:00:00Z",
      "endDate": "2026-01-15T23:00:00Z"
    }
  ]
}

Step 3: Get Event Sessions​

Retrieve sessions for a specific event:

curl -X POST "http://tempsreel-pre.connect.tickandlive.com/api/v1/catalog/event-sessions" \
  -H "x-tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "eventId": 12345,
    "dateFrom": "2026-01-01",
    "dateTo": "2026-12-31"
  }'

Error Handling​

APIs return standard HTTP status codes:

  • 200 - Success
  • 400 - Bad Request (validation error)
  • 401 - Unauthorized (missing/invalid tenant)
  • 404 - Not Found
  • 500 - Internal Server Error

See Error Handling Guide for details.

Next Steps​

Common Use Cases​

Browse Catalog​

Manage Cart​

Process Orders​