# ticket.event.sold_out

HTML: https://www.app2email.com/docs/api/webhooks/ticket.event.sold_out · Index: https://www.app2email.com/docs/api/llms.txt

A date sold its last public ticket. Once per time it becomes sold out.

Group: Tickets-and-Pay. Header `X-App2email-Event: ticket.event.sold_out`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.event` | object | yes |  |
| `data.event.id` | integer |  | The event's id. |
| `data.event.name` | string |  |  |
| `data.event.slug` | string |  | The last part of the event's address. |
| `data.date` | object | yes | The date, without counts. |
| `data.date.id` | integer |  | The date's id. |
| `data.date.event_id` | integer |  | The event it belongs to. |
| `data.date.start` | string |  | When it starts (UTC). |
| `data.date.end` | string |  | When it ends (UTC). |
| `data.date.start_local` | string |  | The start as clock time in the event's time zone (yyyy-MM-ddTHH:mm). |
| `data.date.end_local` | string |  | The end as clock time in the event's time zone. |
| `data.date.label` | string |  | A short name of the date, eg Late show. Empty when it has none. |
| `data.date.capacity` | integer |  | How many people fit: the date's own limit, else the event's; with a seat plan the places of the plan. null = no limit. |
| `data.date.sales` | string |  | paused: nothing is sold for this date right now.; one of: `on`, `paused` |
| `data.date.status` | string |  | one of: `scheduled`, `ended`, `cancelled` |
| `data.date.sold` | integer |  | Valid tickets (extras not counted). The five counts sold, people, held, left and checked_in are null inside webhook events, in the door list and in next_date of the events list. |
| `data.date.people` | integer |  | The people those tickets admit (a group ticket admits several). |
| `data.date.held` | integer |  | People in baskets right now. |
| `data.date.left` | integer |  | People that can still be sold. null = no limit, or the counts were not read. |
| `data.date.checked_in` | integer |  | People admitted at the door. |
| `data.date.sold_out` | boolean |  | The date sold its last public ticket and no place has come back since. |
| `data.date.changed` | string |  | When the time or the venue last changed and ticket holders were told. |
| `data.date.cancelled` | string |  | When the date was cancelled. |
| `data.sold` | integer | yes | Valid tickets of the date. |
| `data.timestamp` | string | yes |  |

## Samples

### sold out

```json
{
  "id": "evt_Tkt3k9m2Lw8Rt5Yp1Zs05",
  "type": "ticket.event.sold_out",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "event": {
      "id": 12,
      "name": "Summer Quiz",
      "slug": "summer-quiz"
    },
    "date": {
      "id": 31,
      "event_id": 12,
      "start": "2026-12-12T08:30:00.000Z",
      "end": "2026-12-12T10:30:00.000Z",
      "start_local": "2026-12-12T19:30",
      "end_local": "2026-12-12T21:30",
      "label": "",
      "capacity": 120,
      "sales": "on",
      "status": "scheduled",
      "sold": null,
      "people": null,
      "held": null,
      "left": null,
      "checked_in": null,
      "sold_out": true,
      "changed": null,
      "cancelled": null
    },
    "sold": 120,
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

## Caused by

- [Change an event](https://www.app2email.com/docs/api/tickets-and-pay/update-ticket-event.md): `PATCH /v1/{number}/tickets/events/{id}`
- [Change a date: time, label, capacity, sales on or paused](https://www.app2email.com/docs/api/tickets-and-pay/update-ticket-date.md): `PATCH /v1/{number}/tickets/dates/{date_id}`
- [Change or archive a ticket type](https://www.app2email.com/docs/api/tickets-and-pay/update-ticket-type.md): `PATCH /v1/{number}/tickets/types/{type_id}`
- [Issue complimentary tickets or record a sale paid outside](https://www.app2email.com/docs/api/tickets-and-pay/create-ticket-order.md): `POST /v1/{number}/tickets/orders`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=ticket.event.sold_out
