list_events
Read-only
Use to find cards. Lists events newest first with the venue, status, number of fights and main event. Filter by season (year) and status (scheduled or final). Costs 1 credit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max events (default 50). | |
| league | No | League. Defaults to mma. One of: mma, pfl, bellator. | |
| offset | No | Page offset; use next_offset. | |
| season | No | Year, e.g. 2025. | |
| status | No | Only upcoming or only completed cards. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| events | Yes | ||
| next_offset | No |