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

# List items for an event

> Buy-now items, auction lots, pledges, raffles, GLI raffles, and tickets grouped by category. Custom Data Export and Blackbaud variants today.

Lists all sellable / biddable items for an event, grouped by category, as an [`ItemsBundle`](/events-auctions/schemas#itemsbundle).

Available in two of the three families today:

| Family             | Path                                              | Payload                                              |
| ------------------ | ------------------------------------------------- | ---------------------------------------------------- |
| Custom Data Export | `GET /<your-namespace>/v1/events/{eventId}/items` | Full record fields.                                  |
| Blackbaud          | `GET /blackbaud/v1/events/{eventId}/items`        | Lean record fields tailored for Blackbaud ingestion. |

<Info>
  **Coming Soon — list-items on the Salesforce connector family.** If you need item data via a Salesforce-shaped payload, contact [support@givergy.com](mailto:support@givergy.com).
</Info>

## Authorization

<Tabs>
  <Tab title="Custom Data Export">
    The authenticated caller must be the dedicated service user provisioned for your integration, and have access to the event.

    <Note>
      Custom Data Export endpoints require a dedicated service user provisioned per customer. Contact [support@givergy.com](mailto:support@givergy.com) to set up your integration.
    </Note>
  </Tab>

  <Tab title="Blackbaud">
    The authenticated caller must have access to the event. No dedicated-user restriction.

    <Note>
      The Blackbaud connector is a partner-specific integration. Contact [support@givergy.com](mailto:support@givergy.com) to enable the connector for your organization.
    </Note>
  </Tab>
</Tabs>

## Path parameters

| Name      | Type | Notes                                                                        |
| --------- | ---- | ---------------------------------------------------------------------------- |
| `eventId` | UUID | EMS event id (returned by [List events](/events-auctions/endpoints/events)). |

## Query parameters

| Name     | Type   | Default      | Notes                                      |
| -------- | ------ | ------------ | ------------------------------------------ |
| `q`      | string | `""`         | Full-text filter applied **per category**. |
| `since`  | long   | `1606062358` | `updated >= since`.                        |
| `offset` | int    | `0`          | Applied **per category** independently.    |
| `limit`  | int    | `1000`       | Page size per category. Maximum `1000`.    |

<Warning>
  `offset` and `limit` apply **per category** in the response, not across the whole bundle. If you have more than 1000 records in any single category, paginate by re-issuing the request with rising `offset` until every category returns an empty array. See [Polling pattern → Bundle pagination caveat](/events-auctions/polling-pattern#bundle-pagination-caveat).
</Warning>

## Response

[`ItemsBundle`](/events-auctions/schemas#itemsbundle) — always the same wrapper shape, with the per-record fields varying by family:

<Tabs>
  <Tab title="Custom Data Export">
    Returns the **full variants** of `BuyNowItem`, `AuctionItem`, `Pledge`, `Raffle`, `Ticket`, and `GliRaffle`.

    The Custom Data Export item types include descriptive fields the connector variants strip:

    * `revenueStreamType`, `externalId`, `categories`, `irsSubcategory`
    * `startPrice`, `increments`, `description`, `termsDescription`
    * `taxRate`, `estimate` (where applicable)

    See [Payload customization examples](/events-auctions/overview#payload-customization-examples) for the full comparison.
  </Tab>

  <Tab title="Blackbaud">
    Returns the **Blackbaud (lean) variants** of every item type. Compared to Custom Data Export, descriptive fields are stripped — the connector returns only what Blackbaud's data model natively ingests.

    See [Payload customization examples](/events-auctions/overview#payload-customization-examples) for the per-type field list.
  </Tab>
</Tabs>

## Example

<Tabs>
  <Tab title="Custom Data Export">
    ```bash theme={null}
    curl --cookie session.cookie \
      '{EMS_BASE_URL}/<your-namespace>/v1/events/8f3c2a1d-9b4e-4c7a-a1d2-6e5f4c3b2a10/items?since=1714000000'
    ```

    See the [full `ItemsBundle` (Custom Data Export) example response](/events-auctions/schemas#example-itemsbundle-custom-data-export-response).
  </Tab>

  <Tab title="Blackbaud">
    ```bash theme={null}
    curl --cookie session.cookie \
      '{EMS_BASE_URL}/blackbaud/v1/events/8f3c2a1d-9b4e-4c7a-a1d2-6e5f4c3b2a10/items?since=1714000000'
    ```

    Same wrapper shape as the Custom Data Export example, but each record has the connector-stripped field set.
  </Tab>
</Tabs>

## What's in the response

`ItemsBundle` has six top-level keys, each holding an array of records of one type:

| Wrapper key    | Record type                                           | What it represents                                    |
| -------------- | ----------------------------------------------------- | ----------------------------------------------------- |
| `buyNows`      | [`BuyNowItem`](/events-auctions/schemas#buynowitem)   | Fixed-price items guests can purchase immediately.    |
| `auctionItems` | [`AuctionItem`](/events-auctions/schemas#auctionitem) | Auction lots that guests bid on.                      |
| `pledges`      | [`Pledge`](/events-auctions/schemas#pledge)           | Donation asks (fixed or open-amount).                 |
| `prizeDraws`   | [`Raffle`](/events-auctions/schemas#raffle)           | Standard ticketed prize draws.                        |
| `gliRaffles`   | [`GliRaffle`](/events-auctions/schemas#gliraffle)     | GLI-regulated raffles (separate compliance handling). |
| `tickets`      | [`Ticket`](/events-auctions/schemas#ticket)           | Event-entry ticket types.                             |

The wrapper shape is constant across every family — only the contents of each array change between the Custom Data Export and connector variants.