> ## 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.

# Line items

> Query registrant invoice lines and their change history

## swoogo\_get\_line\_items

List registrant line items for an event: the itemized invoice behind each registrant's charges, with net, tax, gross, and quantity per package, session, registrant type, or question line.

This tool is read-only and always event-scoped. There is no single-line-item lookup by ID.

### Parameters

| Parameter       | Type    | Required | Description                                                                       |
| --------------- | ------- | -------- | --------------------------------------------------------------------------------- |
| `event_id`      | integer | Yes      | Event to list line items for                                                      |
| `registrant_id` | integer | No       | Filter to one registrant's invoice lines                                          |
| `object`        | string  | No       | Filter by the line's source object (`package`, `session`, `reg_type`, `question`) |
| `search`        | string  | No       | Raw Swoogo search filter                                                          |
| `fields`        | string  | No       | Comma-separated fields to return                                                  |
| `expand`        | string  | No       | Comma-separated related objects to include                                        |
| `page`          | integer | No       | Page number (default: 1)                                                          |
| `per_page`      | integer | No       | Results per page (default: 20, max: 1000)                                         |
| `sort`          | string  | No       | Sort field (prefix `-` for descending)                                            |

<Tip>Line items return current state only. For the history of changes to a line, use `swoogo_get_line_item_audits`.</Tip>

### Example prompts

* *"Show me the invoice lines for registrant 789"*
* *"List all session charges for event 12345"*

***

## swoogo\_get\_line\_item\_audits

List the change history behind registrant line items: price modifications, status changes, and discount applications, each tied to the transaction that caused it.

Use this for reconciliation and "why did this charge change" questions. This tool is read-only and always event-scoped.

### Parameters

| Parameter       | Type    | Required | Description                                |
| --------------- | ------- | -------- | ------------------------------------------ |
| `event_id`      | integer | Yes      | Event to list audit records for            |
| `registrant_id` | integer | No       | Filter to one registrant's history         |
| `search`        | string  | No       | Raw Swoogo search filter                   |
| `fields`        | string  | No       | Comma-separated fields to return           |
| `expand`        | string  | No       | Comma-separated related objects to include |
| `page`          | integer | No       | Page number (default: 1)                   |
| `per_page`      | integer | No       | Results per page (default: 20, max: 1000)  |
| `sort`          | string  | No       | Sort field (prefix `-` for descending)     |

### Example prompts

* *"Why did registrant 789's charge change?"*
* *"Show me every discount applied in event 12345"*