Events API

API endpoints for managing and retrieving events

Access and manage FTC competition events.

List events

GET /v1/events

Query parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`perPage`	integer	Items per page (default: 25, max: 100)
`season`	string	Filter by season (e.g. `2024-2025`)
`status`	string	`upcoming`, `live`, or `past`
`region`	string	Filter by region code
`search`	string	Search event names

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.clipfarm.watch/v1/events?status=upcoming"

{
  "data": [
    {
      "id": "USTXDA1",
      "name": "Texas State Championship",
      "season": "2024-2025",
      "startDate": "2025-02-15T09:00:00Z",
      "endDate": "2025-02-15T18:00:00Z",
      "location": {
        "venue": "George R. Brown Convention Center",
        "city": "Houston",
        "state": "TX",
        "country": "USA"
      },
      "status": "upcoming",
      "streamStatus": "scheduled",
      "teamCount": 48,
      "clipCount": 0
    }
  ],
  "meta": { "page": 1, "perPage": 25, "total": 127 }
}

Get event

GET /v1/events/:eventId

Parameter	Type	Description
`eventId`	string	Event code (e.g. `USTXDA1`)

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.clipfarm.watch/v1/events/USTXDA1"

Create event

Organizers only.

POST /v1/events

{
  "name": "My Local Tournament",
  "season": "2024-2025",
  "startDate": "2025-03-01T09:00:00Z",
  "endDate": "2025-03-01T17:00:00Z",
  "location": {
    "venue": "High School Gym",
    "city": "Austin",
    "state": "TX",
    "country": "USA"
  },
  "visibility": "public"
}

Update event

Organizers only.

PATCH /v1/events/:eventId

Delete event

Admins only.

DELETE /v1/events/:eventId

Sub-resources

GET /v1/events/:eventId/teams
GET /v1/events/:eventId/matches
GET /v1/events/:eventId/clips

Clips support additional filtering:

Parameter	Type	Description
`matchType`	string	`qualification`, `semifinal`, or `final`
`teamNumber`	integer	Filter by team number

Status values

Field	Values
`status`	`upcoming`, `live`, `past`
`streamStatus`	`none`, `scheduled`, `live`, `ended`

Events API

On this page