# `PaperTiger.Resources.Event`
[🔗](https://github.com/EnaiaInc/paper_tiger/blob/v1.2.2/lib/paper_tiger/resources/event.ex#L1)

Handles Event resource endpoints.

## Endpoints

- GET    /v1/events/:id  - Retrieve event
- GET    /v1/events      - List events

Note: Events are auto-generated by the system and are immutable.
No create, update, or delete operations are supported.

## Event Object

    %{
      id: "evt_...",
      object: "event",
      created: 1234567890,
      type: "customer.created",
      data: %{
        object: %{
          id: "cus_...",
          object: "customer",
          # ... customer fields
        }
      },
      livemode: false
    }

# `list`

```elixir
@spec list(Plug.Conn.t()) :: Plug.Conn.t()
```

Lists all events with pagination.

## Parameters

- limit - Number of items (default: 10, max: 100)
- starting_after - Cursor for pagination
- ending_before - Reverse cursor
- type - Filter by event type

# `retrieve`

```elixir
@spec retrieve(Plug.Conn.t(), String.t()) :: Plug.Conn.t()
```

Retrieves an event by ID.

---

*Consult [api-reference.md](api-reference.md) for complete listing*