API Documentation

Everything you need to integrate Tandum into your application

Quick Links

Getting Started

Base URL

https://api.tandum.io/v1/v1

Quick Example

curl -X POST https://api.tandum.io/v1/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your-password"
  }'

Authentication

Tandum API uses JWT (JSON Web Tokens) for authentication. Include the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Getting an Access Token

  1. Register a new account via /v1/auth/register
  2. Login with your credentials via /v1/auth/login
  3. Use the returned accessToken in subsequent requests
  4. Refresh your token when it expires using /v1/auth/refresh

Code Examples

JavaScript / TypeScript

const response = await fetch('https://api.tandum.io/v1/v1/bookings', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  }
});

const bookings = await response.json();

Python

import requests

headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.tandum.io/v1/v1/bookings', headers=headers)
bookings = response.json()