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

# Events

> Query events, fuzzy-match by name, and fetch complete event bundles

## swoogo\_get\_events

Look up Swoogo events with search, filter, and pagination support. Pass an `event_id` for a single event's details, or filter to list events.

### Parameters

| Parameter  | Type    | Required | Description                              |
| ---------- | ------- | -------- | ---------------------------------------- |
| `event_id` | integer | No       | Get a single event by ID                 |
| `name`     | string  | No       | Filter by event name (partial match)     |
| `status`   | string  | No       | Filter by status                         |
| `search`   | string  | No       | Raw Swoogo search filter                 |
| `fields`   | string  | No       | Comma-separated fields to return         |
| `expand`   | string  | No       | Include related objects                  |
| `page`     | integer | No       | Page number (default: 1)                 |
| `per_page` | integer | No       | Results per page (default: 20, max: 100) |
| `sort`     | string  | No       | Sort field (prefix `-` for descending)   |

### Example prompts

* *"Show me all active events"*
* *"Get details for event 12345"*
* *"List events sorted by date"*

***

## swoogo\_find\_event

Fuzzy-match an event by name. Handles typos, partial matches, and abbreviations. Returns the best match with a confidence score, or a list of candidates.

### Parameters

| Parameter | Type   | Required | Description                                                |
| --------- | ------ | -------- | ---------------------------------------------------------- |
| `name`    | string | Yes      | Event name to search for (supports partial/fuzzy matching) |
| `status`  | string | No       | Filter by event status                                     |

### Example prompts

* *"Find the annual sales conference"*
* *"Which event is called something like 'tech summit 2025'?"*

***

## swoogo\_get\_event\_bundle

Fetch complete event data in a single call — event details, sessions, speakers, sponsors, packages, registration types, and form questions.

### Parameters

| Parameter  | Type    | Required | Description  |
| ---------- | ------- | -------- | ------------ |
| `event_id` | integer | Yes      | The event ID |

### Example prompts

* *"Give me everything about event 12345"*
* *"What's the full setup for our conference?"*