Matches

Returns the Matches in the published schedule of one Event. Results are paged.

List Matches

GET

https://api.fastbreak.ai

/v1/organizations/{orgId}/events/{eventId}/matches

Returns the Matches in the published schedule of one Event. If the Event has no published schedule, the list is empty.

List Matches › path Parameters

orgId

string · uuid · required

Public ID of the Organization.

eventId

string · uuid · required

Public ID of the Event.

List Matches › query Parameters

page_token

string

Opaque token from the previous next_page_token. Do not parse this value. A token belongs to one list and one set of filters. Omit this parameter for the first page.

max_page_size

integer · min: 1 · max: 100

Maximum number of items in the page. The minimum is 1. The maximum is 100. If you omit this parameter, the page size is 100.

Default: 100

List Matches › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List Matches › Responses

One page of Matches

object[] · required

Matches in this page.

next_page_token

string · required

Opaque token for the next page. An empty string means there is no next page. Send this value as page_token. Do not parse it.

GET/v1/organizations/{orgId}/events/{eventId}/matches

curl https://api.fastbreak.ai/v1/organizations/:orgId/events/:eventId/matches \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "matches": [
    {
      "id": "018f6b3a-7c21-7000-8000-000000000020",
      "number": 6,
      "status": "to_be_played",
      "start": "2026-09-12T09:00:00",
      "end": "2026-09-12T10:20:00",
      "teams": [
        {
          "id": "018f6b3a-7c21-7000-8000-000000000021",
          "name": "Northside 14U",
          "definition": "competing_team",
          "home": true,
          "away": false,
          "win_count": 0,
          "loss_count": 0,
          "draw_count": 0,
          "source": null
        },
        {
          "id": "018f6b3a-7c21-7000-8000-000000000022",
          "name": "Lakeside 14U",
          "definition": "competing_team",
          "home": false,
          "away": true,
          "win_count": 0,
          "loss_count": 0,
          "draw_count": 0,
          "source": null
        }
      ],
      "games": [
        {
          "sides": [
            {
              "team_id": "018f6b3a-7c21-7000-8000-000000000021",
              "team_name": "Northside 14U",
              "score": null
            },
            {
              "team_id": "018f6b3a-7c21-7000-8000-000000000022",
              "team_name": "Lakeside 14U",
              "score": null
            }
          ]
        }
      ],
      "play_surface": {
        "name": "Court 1",
        "venue": {
          "name": "Northside Gym",
          "address": {
            "street": "100 Main St",
            "street_2": null,
            "city": "Chicago",
            "state": "IL",
            "zip_code": "60601",
            "country": "US",
            "latitude": 41.88,
            "longitude": -87.63
          }
        }
      },
      "schedule_division": {
        "id": "018f6b3a-7c21-7000-8000-000000000012",
        "name": "14U Girls Gold",
        "gender": "female",
        "age_group": "14U",
        "order": 1,
        "stage": {
          "id": "018f6b3a-7c21-7000-8000-000000000031",
          "name": "Pool Play",
          "label": "Pool Play",
          "type": "pool",
          "order": 1,
          "pool": {
            "id": "018f6b3a-7c21-7000-8000-000000000030",
            "name": "Pool A",
            "short_name": "A",
            "order": 1
          }
        }
      }
    }
  ],
  "next_page_token": ""
}

json

application/json

Events

List Matches

GET

https://api.fastbreak.ai

/v1/organizations/{orgId}/events/{eventId}/matches

Returns the Matches in the published schedule of one Event. If the Event has no published schedule, the list is empty.

List Matches › path Parameters

orgId

string · uuid · required

Public ID of the Organization.

eventId

string · uuid · required

Public ID of the Event.

List Matches › query Parameters

page_token

string

Opaque token from the previous next_page_token. Do not parse this value. A token belongs to one list and one set of filters. Omit this parameter for the first page.

max_page_size

integer · min: 1 · max: 100

Maximum number of items in the page. The minimum is 1. The maximum is 100. If you omit this parameter, the page size is 100.

Default: 100

List Matches › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List Matches › Responses

One page of Matches

object[] · required

Matches in this page.

next_page_token

string · required

Opaque token for the next page. An empty string means there is no next page. Send this value as page_token. Do not parse it.