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

# ticketing.capacity.exceeded

> Ticketing capacity was exceeded.

# ticketing.capacity.exceeded

> Generated from COPE public event contracts. Do not edit this page by hand.

Use this event to notify vendor workflows that a paid order exceeded available ticketing capacity and requires review.

## Delivery Contract

| Field           | Value                                                                                |
| --------------- | ------------------------------------------------------------------------------------ |
| Encoding        | CloudEvents 1.0 structured JSON                                                      |
| Delivery        | At least once                                                                        |
| Idempotency     | Use the CloudEvents `source` + `id` tuple, or COPE `idempotency_key` when available. |
| Source          | `cope.ticketing`                                                                     |
| Subject pattern | `capacity:<identifier>`                                                              |
| Category        | Ticketing                                                                            |
| Availability    | Planned; not currently emitted.                                                      |
| Schema title    | ticketing.capacity.exceeded v1 payload                                               |
| Schema ID       | `https://schemas.cope.com/events/ticketing.capacity.exceeded/v1`                     |

## Payload Fields

| Field                  | Required | Type      | Allowed Values                | Description |
| ---------------------- | -------- | --------- | ----------------------------- | ----------- |
| `capacity`             | yes      | `integer` | -                             | -           |
| `capacity_incident_id` | yes      | `string`  | -                             | -           |
| `event_id`             | yes      | `string`  | -                             | -           |
| `event_product_id`     | yes      | `string`  | -                             | -           |
| `event_type`           | yes      | `const`   | `ticketing.capacity.exceeded` | -           |
| `exceeded_by`          | yes      | `integer` | -                             | -           |
| `occurred_at`          | yes      | `string`  | -                             | -           |
| `order_id`             | yes      | `string`  | -                             | -           |
| `quantity`             | yes      | `integer` | -                             | -           |
| `resolution_status`    | yes      | `enum`    | `requires_review`, `resolved` | -           |
| `schema_version`       | yes      | `const`   | `1.0`                         | -           |
| `sold_count`           | yes      | `integer` | -                             | -           |

## Example CloudEvent

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "capacity": 1000,
    "capacity_incident_id": "example_id",
    "event_id": "example_id",
    "event_product_id": "example_id",
    "event_type": "ticketing.capacity.exceeded",
    "exceeded_by": 1000,
    "occurred_at": "2026-05-05T12:00:00.000Z",
    "order_id": "example_id",
    "quantity": 1000,
    "resolution_status": "requires_review",
    "schema_version": "1.0",
    "sold_count": 1000
  },
  "datacontenttype": "application/json",
  "dataschema": "https://schemas.cope.com/events/ticketing.capacity.exceeded/v1",
  "id": "ticketing.capacity.exceeded:example",
  "idempotency_key": "ticketing.capacity.exceeded:example",
  "source": "cope.ticketing",
  "specversion": "1.0",
  "subject": "capacity:example",
  "time": "2026-05-05T12:00:00.000Z",
  "type": "ticketing.capacity.exceeded"
}
```

## Compatibility

Fields may be added within the same major version. Removing or changing the meaning of a documented field requires a new event version.