---
title: "List Events"
method: GET
path: "/v1/events/"
tags: ["events", "public"]
---

# List Events

`GET /v1/events/`

List events.

**Scopes**: `events:read` `events:write`

## Query parameters

- `filter` string, nullable — Filter events following filter clauses. JSON string following the same schema a meter filter clause.
- `start_timestamp` string, date-time, nullable — Filter events after this timestamp.
- `end_timestamp` string, date-time, nullable — Filter events before this timestamp.
- `organization_id` union — Filter by organization ID.
  - string, uuid4 — The organization ID.
  - string[]
- `customer_id` union — Filter by customer ID.
  - string, uuid4 — The customer ID.
  - string[]
- `external_customer_id` union — Filter by external customer ID.
  - string
  - string[]
- `meter_id` string, uuid4, nullable — The meter ID.
- `name` union — Filter by event name.
  - string
  - string[]
- `source` union — Filter by event source.
  - 'system' | 'user'
  - EventSource[]
- `query` string, nullable — Query to filter events.
- `parent_id` string, uuid4, nullable — The event ID.
- `depth` integer, nullable — Fetch descendants up to this depth. When set: 0=root events only, 1=roots+children, etc. Max 5. When not set, returns all events.
- `page` integer — Page number, defaults to 1.
- `limit` integer — Size of a page, defaults to 10. Maximum is 100.
- `sorting` EventSortProperty[], nullable — Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign `-` before the criteria name to sort by descending order.
- `metadata` MetadataQuery, nullable

## Response `200`

Successful Response

- union
  - ListResourceEvent
    - `items` Event[], required
      - union
        - union
          - MeterCreditEvent — An event created by Polar when credits are added to a customer meter.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'meter.credited', required — The name of the event.
            - `metadata` MeterCreditedMetadata, required
              - …
          - MeterResetEvent — An event created by Polar when a customer meter is reset.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'meter.reset', required — The name of the event.
            - `metadata` MeterResetMetadata, required
              - …
          - BenefitGrantedEvent — An event created by Polar when a benefit is granted to a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.granted', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitCycledEvent — An event created by Polar when a benefit is cycled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.cycled', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitUpdatedEvent — An event created by Polar when a benefit is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.updated', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitRevokedEvent — An event created by Polar when a benefit is revoked from a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.revoked', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - SubscriptionCreatedEvent — An event created by Polar when a subscription is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.created', required — The name of the event.
            - `metadata` SubscriptionCreatedMetadata, required
              - …
          - SubscriptionUpdatedEvent — An event created by Polar when a subscription is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.updated', required — The name of the event.
            - `metadata` SubscriptionUpdatedMetadata, required
              - …
          - SubscriptionCycledEvent — An event created by Polar when a subscription is cycled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.cycled', required — The name of the event.
            - `metadata` SubscriptionCycledMetadata, required
              - …
          - SubscriptionCanceledEvent — An event created by Polar when a subscription is canceled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.canceled', required — The name of the event.
            - `metadata` SubscriptionCanceledMetadata, required
              - …
          - SubscriptionRevokedEvent — An event created by Polar when a subscription is revoked from a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.revoked', required — The name of the event.
            - `metadata` SubscriptionRevokedMetadata, required
              - …
          - SubscriptionPastDueEvent — An event created by Polar when a subscription becomes past due.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.past_due', required — The name of the event.
            - `metadata` SubscriptionPastDueMetadata, required
              - …
          - SubscriptionReactivatedEvent — An event created by Polar when a past due subscription is recovered.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.reactivated', required — The name of the event.
            - `metadata` SubscriptionReactivatedMetadata, required
              - …
          - SubscriptionReinstatedEvent — An event created by Polar when a canceled subscription is reinstated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.reinstated', required — The name of the event.
            - `metadata` SubscriptionReinstatedMetadata, required
              - …
          - SubscriptionPausedEvent — An event created by Polar when a subscription is paused.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.paused', required — The name of the event.
            - `metadata` SubscriptionPausedMetadata, required
              - …
          - SubscriptionResumedEvent — An event created by Polar when a paused subscription is resumed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.resumed', required — The name of the event.
            - `metadata` SubscriptionResumedMetadata, required
              - …
          - SubscriptionUncanceledEvent — An event created by Polar when a subscription cancellation is reversed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.uncanceled', required — The name of the event.
            - `metadata` SubscriptionUncanceledMetadata, required
              - …
          - SubscriptionProductUpdatedEvent — An event created by Polar when a subscription changes the product.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.product_updated', required — The name of the event.
            - `metadata` SubscriptionProductUpdatedMetadata, required
              - …
          - SubscriptionSeatsUpdatedEvent — An event created by Polar when a the seats on a subscription is changed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.seats_updated', required — The name of the event.
            - `metadata` SubscriptionSeatsUpdatedMetadata, required
              - …
          - SubscriptionBillingPeriodUpdatedEvent — An event created by Polar when a subscription billing period is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.billing_period_updated', required — The name of the event.
            - `metadata` SubscriptionBillingPeriodUpdatedMetadata, required
              - …
          - SubscriptionUpdateClearedEvent — An event created by Polar when a pending subscription update is cleared without being applied.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.update_cleared', required — The name of the event.
            - `metadata` SubscriptionUpdateClearedMetadata, required
              - …
          - OrderPaidEvent — An event created by Polar when an order is paid.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.paid', required — The name of the event.
            - `metadata` OrderPaidMetadata, required
              - …
          - OrderRefundedEvent — An event created by Polar when an order is refunded.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.refunded', required — The name of the event.
            - `metadata` OrderRefundedMetadata, required
              - …
          - OrderVoidedEvent — An event created by Polar when an order is voided.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.voided', required — The name of the event.
            - `metadata` OrderVoidedMetadata, required
              - …
          - OrderUnvoidedEvent — An event created by Polar when an order is unvoided.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.unvoided', required — The name of the event.
            - `metadata` OrderUnvoidedMetadata, required
              - …
          - CheckoutCreatedEvent — An event created by Polar when a checkout is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'checkout.created', required — The name of the event.
            - `metadata` CheckoutCreatedMetadata, required
              - …
          - CustomerCreatedEvent — An event created by Polar when a customer is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.created', required — The name of the event.
            - `metadata` CustomerCreatedMetadata, required
              - …
          - CustomerUpdatedEvent — An event created by Polar when a customer is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.updated', required — The name of the event.
            - `metadata` CustomerUpdatedMetadata, required
              - …
          - CustomerDeletedEvent — An event created by Polar when a customer is deleted.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.deleted', required — The name of the event.
            - `metadata` CustomerDeletedMetadata, required
              - …
          - BalanceOrderEvent — An event created by Polar when an order is paid.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.order', required — The name of the event.
            - `metadata` BalanceOrderMetadata, required
              - …
          - BalanceCreditOrderEvent — An event created by Polar when an order is paid via customer balance.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.credit_order', required — The name of the event.
            - `metadata` BalanceCreditOrderMetadata, required
              - …
          - BalanceRefundEvent — An event created by Polar when an order is refunded.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.refund', required — The name of the event.
            - `metadata` BalanceRefundMetadata, required
              - …
          - BalanceRefundReversalEvent — An event created by Polar when a refund is reverted.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.refund_reversal', required — The name of the event.
            - `metadata` BalanceRefundMetadata, required
              - …
          - BalanceDisputeEvent — An event created by Polar when an order is disputed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.dispute', required — The name of the event.
            - `metadata` BalanceDisputeMetadata, required
              - …
          - BalanceDisputeReversalEvent — An event created by Polar when a dispute is won and funds are reinstated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.dispute_reversal', required — The name of the event.
            - `metadata` BalanceDisputeMetadata, required
              - …
        - UserEvent — An event you created through the ingestion API.
          - `id` string, uuid4, required — The ID of the object.
          - `timestamp` string, date-time, required — The timestamp of the event.
          - `organization_id` string, uuid4, required — The ID of the organization owning the event.
          - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
          - `customer` Customer, required — unresolved $ref
          - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
          - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
          - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
          - `child_count` integer — Number of direct child events linked to this event.
          - `parent_id` string, uuid4, nullable — The ID of the parent event.
          - `label` string, required — Human readable label of the event type.
          - `name` string, required — The name of the event.
          - `source` 'user', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
          - `metadata` EventMetadataOutput, required
            - `_cost` CostMetadataOutput
              - …
            - `_llm` LLMMetadata
              - …
    - `pagination` Pagination, required
      - `total_count` integer, required
      - `max_page` integer, required
  - ListResourceWithCursorPaginationEvent
    - `items` Event[], required
      - union
        - union
          - MeterCreditEvent — An event created by Polar when credits are added to a customer meter.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'meter.credited', required — The name of the event.
            - `metadata` MeterCreditedMetadata, required
              - …
          - MeterResetEvent — An event created by Polar when a customer meter is reset.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'meter.reset', required — The name of the event.
            - `metadata` MeterResetMetadata, required
              - …
          - BenefitGrantedEvent — An event created by Polar when a benefit is granted to a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.granted', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitCycledEvent — An event created by Polar when a benefit is cycled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.cycled', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitUpdatedEvent — An event created by Polar when a benefit is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.updated', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - BenefitRevokedEvent — An event created by Polar when a benefit is revoked from a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'benefit.revoked', required — The name of the event.
            - `metadata` BenefitGrantMetadata, required
              - …
          - SubscriptionCreatedEvent — An event created by Polar when a subscription is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.created', required — The name of the event.
            - `metadata` SubscriptionCreatedMetadata, required
              - …
          - SubscriptionUpdatedEvent — An event created by Polar when a subscription is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.updated', required — The name of the event.
            - `metadata` SubscriptionUpdatedMetadata, required
              - …
          - SubscriptionCycledEvent — An event created by Polar when a subscription is cycled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.cycled', required — The name of the event.
            - `metadata` SubscriptionCycledMetadata, required
              - …
          - SubscriptionCanceledEvent — An event created by Polar when a subscription is canceled.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.canceled', required — The name of the event.
            - `metadata` SubscriptionCanceledMetadata, required
              - …
          - SubscriptionRevokedEvent — An event created by Polar when a subscription is revoked from a customer.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.revoked', required — The name of the event.
            - `metadata` SubscriptionRevokedMetadata, required
              - …
          - SubscriptionPastDueEvent — An event created by Polar when a subscription becomes past due.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.past_due', required — The name of the event.
            - `metadata` SubscriptionPastDueMetadata, required
              - …
          - SubscriptionReactivatedEvent — An event created by Polar when a past due subscription is recovered.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.reactivated', required — The name of the event.
            - `metadata` SubscriptionReactivatedMetadata, required
              - …
          - SubscriptionReinstatedEvent — An event created by Polar when a canceled subscription is reinstated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.reinstated', required — The name of the event.
            - `metadata` SubscriptionReinstatedMetadata, required
              - …
          - SubscriptionPausedEvent — An event created by Polar when a subscription is paused.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.paused', required — The name of the event.
            - `metadata` SubscriptionPausedMetadata, required
              - …
          - SubscriptionResumedEvent — An event created by Polar when a paused subscription is resumed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.resumed', required — The name of the event.
            - `metadata` SubscriptionResumedMetadata, required
              - …
          - SubscriptionUncanceledEvent — An event created by Polar when a subscription cancellation is reversed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.uncanceled', required — The name of the event.
            - `metadata` SubscriptionUncanceledMetadata, required
              - …
          - SubscriptionProductUpdatedEvent — An event created by Polar when a subscription changes the product.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.product_updated', required — The name of the event.
            - `metadata` SubscriptionProductUpdatedMetadata, required
              - …
          - SubscriptionSeatsUpdatedEvent — An event created by Polar when a the seats on a subscription is changed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.seats_updated', required — The name of the event.
            - `metadata` SubscriptionSeatsUpdatedMetadata, required
              - …
          - SubscriptionBillingPeriodUpdatedEvent — An event created by Polar when a subscription billing period is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.billing_period_updated', required — The name of the event.
            - `metadata` SubscriptionBillingPeriodUpdatedMetadata, required
              - …
          - SubscriptionUpdateClearedEvent — An event created by Polar when a pending subscription update is cleared without being applied.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'subscription.update_cleared', required — The name of the event.
            - `metadata` SubscriptionUpdateClearedMetadata, required
              - …
          - OrderPaidEvent — An event created by Polar when an order is paid.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.paid', required — The name of the event.
            - `metadata` OrderPaidMetadata, required
              - …
          - OrderRefundedEvent — An event created by Polar when an order is refunded.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.refunded', required — The name of the event.
            - `metadata` OrderRefundedMetadata, required
              - …
          - OrderVoidedEvent — An event created by Polar when an order is voided.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.voided', required — The name of the event.
            - `metadata` OrderVoidedMetadata, required
              - …
          - OrderUnvoidedEvent — An event created by Polar when an order is unvoided.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'order.unvoided', required — The name of the event.
            - `metadata` OrderUnvoidedMetadata, required
              - …
          - CheckoutCreatedEvent — An event created by Polar when a checkout is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'checkout.created', required — The name of the event.
            - `metadata` CheckoutCreatedMetadata, required
              - …
          - CustomerCreatedEvent — An event created by Polar when a customer is created.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.created', required — The name of the event.
            - `metadata` CustomerCreatedMetadata, required
              - …
          - CustomerUpdatedEvent — An event created by Polar when a customer is updated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.updated', required — The name of the event.
            - `metadata` CustomerUpdatedMetadata, required
              - …
          - CustomerDeletedEvent — An event created by Polar when a customer is deleted.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'customer.deleted', required — The name of the event.
            - `metadata` CustomerDeletedMetadata, required
              - …
          - BalanceOrderEvent — An event created by Polar when an order is paid.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.order', required — The name of the event.
            - `metadata` BalanceOrderMetadata, required
              - …
          - BalanceCreditOrderEvent — An event created by Polar when an order is paid via customer balance.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.credit_order', required — The name of the event.
            - `metadata` BalanceCreditOrderMetadata, required
              - …
          - BalanceRefundEvent — An event created by Polar when an order is refunded.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.refund', required — The name of the event.
            - `metadata` BalanceRefundMetadata, required
              - …
          - BalanceRefundReversalEvent — An event created by Polar when a refund is reverted.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.refund_reversal', required — The name of the event.
            - `metadata` BalanceRefundMetadata, required
              - …
          - BalanceDisputeEvent — An event created by Polar when an order is disputed.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.dispute', required — The name of the event.
            - `metadata` BalanceDisputeMetadata, required
              - …
          - BalanceDisputeReversalEvent — An event created by Polar when a dispute is won and funds are reinstated.
            - `id` string, uuid4, required — The ID of the object.
            - `timestamp` string, date-time, required — The timestamp of the event.
            - `organization_id` string, uuid4, required — The ID of the organization owning the event.
            - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
            - `customer` Customer, required — unresolved $ref
            - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
            - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
            - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
            - `child_count` integer — Number of direct child events linked to this event.
            - `parent_id` string, uuid4, nullable — The ID of the parent event.
            - `label` string, required — Human readable label of the event type.
            - `source` 'system', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
            - `name` 'balance.dispute_reversal', required — The name of the event.
            - `metadata` BalanceDisputeMetadata, required
              - …
        - UserEvent — An event you created through the ingestion API.
          - `id` string, uuid4, required — The ID of the object.
          - `timestamp` string, date-time, required — The timestamp of the event.
          - `organization_id` string, uuid4, required — The ID of the organization owning the event.
          - `customer_id` string, uuid4, nullable, required — ID of the customer in your Polar organization associated with the event.
          - `customer` Customer, required — unresolved $ref
          - `external_customer_id` string, nullable, required — ID of the customer in your system associated with the event.
          - `member_id` string, uuid4, nullable — ID of the member within the customer's organization who performed the action inside B2B.
          - `external_member_id` string, nullable — ID of the member in your system within the customer's organization who performed the action inside B2B.
          - `child_count` integer — Number of direct child events linked to this event.
          - `parent_id` string, uuid4, nullable — The ID of the parent event.
          - `label` string, required — Human readable label of the event type.
          - `name` string, required — The name of the event.
          - `source` 'user', required — The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
          - `metadata` EventMetadataOutput, required
            - `_cost` CostMetadataOutput
              - …
            - `_llm` LLMMetadata
              - …
    - `pagination` CursorPagination, required
      - `has_next_page` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/964f974aceff/schema)
