---
title: "List launch orgs with capability flags"
method: GET
path: "/v1/orgs"
tags: ["Orgs"]
---

# List launch orgs with capability flags

`GET /v1/orgs`

## Request

- Base URL: `https://api.ufcalendar.com`
- URL: `https://api.ufcalendar.com/v1/orgs`
- Auth: HTTP bearer

Each org carries flags (`stats`, `rounds`, `rankings`, `broadcasts`, `predictions`, `scorecards`, `odds`) so clients discover coverage programmatically — plus `sport` (`mma`, `bare-knuckle-boxing`) and `country_code` (ISO-2). Staged orgs (ONE, KSW, ACA) appear the day they clear the reliability bar. RIZIN publishes no official board, so its `rankings` flag is false. `scorecards` is true for UFC, PFL, OKTAGON and RIZIN; no commission covers bare-knuckle, so BKFC is false.

## Response `200`

Launch orgs

- OrgsResponse
  - `data` Org[], required
    - `id` integer, required
    - `slug` string, required
    - `name` string, required
    - `short_name` string, nullable, required
    - `country` string, nullable, required: Country as stored (a name or an ISO-2 code, depending on the org).
    - `country_code` string, nullable, required: ISO-2 derived from `country`.
    - `website` string, nullable, required
    - `sport` string, required: Sport slug — `mma`, `bare-knuckle-boxing`. Open: a new sport lands as a new value.
    - `capabilities` OrgCapabilities, required: Which datasets this org has coverage for.
      - `stats` boolean, required
      - `rounds` boolean, required
      - `rankings` boolean, required
      - `broadcasts` boolean, required
      - `predictions` boolean, required
      - `scorecards` boolean, required
      - `odds` boolean, required: UFCalendar consensus odds (`/v1/fights/{id}/odds`).
  - `meta` object, required
    - `note` string
    - `ignored_params` string[]: Present only when the request carried query parameters this endpoint does not take — they were ignored. Same list as the `X-UFCalendar-Ignored-Params` header. Sorted, unique.

## Other responses

- `304`: Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body.
- `401`: Missing/invalid API key (`unauthorized`).
- `403`: No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api.
- `404`: Not found (`not_found`; staged-org data 404s until the org is promoted).
- `429`: Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`.
- `500`: Something broke on our side (`internal_error`). It has been logged under the `request_id`.

---

[API](https://skmtc.dev/ufcalendar/apis/ufcalendar-fight-api.md) · [All operations](https://skmtc.dev/ufcalendar/apis/ufcalendar-fight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ufcalendar/apis/ufcalendar-fight-api/revisions/9623cc8fb70b?raw)