Skip to main content

Welcome to 16TMS API

The 16TMS API allows you to integrate tournament management functionality into your application. This API enables you to manage users, tournaments, participants, matches, and more.

Base URL

All API requests should be made to:
For local development or testing, you may use your own server URL.

Authentication

All API endpoints require authentication using an API key. You need to include your API key in the request header.

API Key Authentication

Include your API key in the X-API-KEY header with every request:
Keep your API key secure and never expose it in client-side code. Generate your API key from the 16TMS Console.

Response Format

All API responses follow a consistent format:

Response Fields

  • success: Boolean indicating if the request was successful
  • message: Human-readable message describing the result
  • data: The actual response data (varies by endpoint)
  • meta: Metadata about the request including trace ID, elapsed time, and server timestamp

Error Handling

When an error occurs, the API returns an appropriate HTTP status code along with error details:

Common HTTP Status Codes

  • 200: Success
  • 400: Bad Request - Invalid input data
  • 401: Unauthorized - Invalid or missing API key
  • 404: Not Found - Resource doesn’t exist
  • 500: Internal Server Error