Public API

Slotlist.it Public API

Access public platform data through structured access. No user-identifying data is ever exposed.

Base URL https://slotlist.it/api/v1

General Information

ID Formats

UUID: 8-4-4-4-12 hex
Snowflake: 17–20 digit numeric

Date Format

All dates in UTC ISO 8601
2026-02-11T15:00:00.000Z

Privacy

Slot info never exposes personal data
Only public or unlisted events accessible

Roadmap

More endpoints will be added in future API versions.

Rate Limit: max 50 requests / IP / 15 min. Exceeding returns: { "error": "Too many requests, please try again later." }

Endpoints

GET /events/upcoming — List upcoming public events

Returns a paginated list of upcoming public events, sorted by start date ascending. Only public events are included. Maximum 20 events per request regardless of the limit parameter.

Query Parameters

Name	Type	Required	Description
limit	integer	Optional	Number of events to return. Default: `10`, max: `20`

Response

200 OK

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Event Name",
    "start_time": "2026-02-11T15:00:00.000Z",
    "game": "Arma 3 | Arma Reforger",
    "image": "https://slotlist.it/path/to/image.png" | null,
    "slots": {
      "total": 64,
      "taken": 41,
      "free": 23
    }
  }
]

Error Responses

400

Invalid 'limit' parameter

Must be a positive integer

500

Server Error

An internal error occurred while reading event data

GET /events/:id — Fetch public event details

Fetches public details of a specific event. Only safe, non-sensitive data is returned, no user-identifying information is ever exposed. Only public or unlisted events are accessible.

URL Parameters

Name	Type	Required	Description
id	string	Required	Event ID. Must be a valid UUID

Response

200 OK

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Event Name",
  "game": "Arma 3 | Arma Reforger",
  "status": "upcoming | live | concluded",
  "visibility": "public | unlisted",
  "author": "Author Nickname",
  "community": {
    "name": "Community Name",
    "prefix": "Community Prefix"
  },
  "image": "https://slotlist.it/path/to/image.png" | null,
  "times": {
    "start": "2026-02-11T15:00:00.000Z",
    "end": "2026-02-11T18:00:00.000Z",
    "slotting": "2026-02-10T20:00:00.000Z",
    "briefing": "2026-02-11T14:30:00.000Z"
  },
  "server": {
    "teamspeak": {
      "address": "ts.slotlist.it",
      "port": 1234
    },
    "gameServer": {
      "address": "arma.slotlist.it",
      "port": 2302
    }
  },
  "slots_structure": [
    {
      "name": "Alpha Group",
      "faction": "blufor | opfor | independent | civilian | none",
      "slots": [
        {
          "role": "Rifleman",
          "difficulty": "easy | moderate | challenging | demanding",
          "status": "free | occupied | pending_reservation | reserved_community",
          "description": "Optional role description" | null
        }
      ]
    }
  ]
}

Error Responses

400

Invalid Event ID format

The provided ID is not a valid UUID

403

Access Denied: This event is private

Event visibility is set to private, not publicly accessible

404

Event not found

No event exists with the provided ID

GET /groups/:id — Fetch public group details

Fetches public details of an approved group. Returns general info including name, prefix, member count, and social links. Sensitive member data is never exposed.

URL Parameters

Name	Type	Required	Description
id	string	Required	Group ID. Must be a valid UUID

Response

200 OK

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Group Name",
  "prefix": "Group Prefix",
  "description": "Optional group description",
  "image": "https://slotlist.it/path/to/image.png" | null,
  "members_count": 25,
  "website": "https://example.com" | null,
  "discord": "https://discord.gg/invite" | null
}

Error Responses

400

Invalid Group ID format

The provided ID is not a valid UUID

404

Group not found or not public

No public approved group exists with the provided ID

GET /groups/:id/events — List upcoming events for a group

Returns the list of upcoming public events belonging to a specific group, sorted by start date ascending. Only public events are returned, private or internal events are never exposed.

URL Parameters

Name	Type	Required	Description
id	string	Required	Group ID. Must be a valid UUID

Response

200 OK

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Event Name",
    "start_time": "2026-02-11T15:00:00.000Z",
    "game": "Arma 3 | Arma Reforger",
    "image": "https://slotlist.it/path/to/image.png" | null,
    "slots": {
      "total": 64,
      "taken": 41,
      "free": 23
    }
  }
]

Error Responses

400

Invalid Group ID format

The provided ID is not a valid UUID

403

Group is not public or approved

No public approved group exists with the provided ID

404

Group not found

No group exists with the provided ID

500

Server Error

An internal error occurred while reading event data