> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fieldfunded.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Statuses

> Possible event status values

## Status values

| Status      | Description                    |
| ----------- | ------------------------------ |
| `upcoming`  | Event has not started yet      |
| `live`      | Event is currently in progress |
| `ended`     | Event has finished             |
| `cancelled` | Event was cancelled            |
| `postponed` | Event was postponed            |
| `suspended` | Event is temporarily suspended |

## Filtering by status

```bash theme={null}
# Get only live events
curl "https://api.fieldfunded.com/v1/events?status=live" \
  -H "X-API-Key: YOUR_API_KEY"

# Get ended events for settlement
curl "https://api.fieldfunded.com/v1/events?status=ended" \
  -H "X-API-Key: YOUR_API_KEY"

# Get all statuses
curl "https://api.fieldfunded.com/v1/events?status=all" \
  -H "X-API-Key: YOUR_API_KEY"
```

<Note>
  By default, the Events endpoint excludes ended and cancelled events. Use `?status=all` to include all statuses.
</Note>