# ticket.checked_in

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

A ticket was admitted for the first time (not for a re-entry, a check-out or a refused scan). page_url is empty in events: read the order with GET /tickets/orders/{id}.

Group: Tickets-and-Pay. Header `X-App2email-Event: ticket.checked_in`. 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.ticket` | object | yes | One ticket (or one extra) of an order, with its check-in state. The ticket code, the text of its QR code, is never in an answer. Also inside ticket.checked_in and ticket.passed_on, there with an empty page_url. |
| `data.ticket.id` | integer |  | The ticket's id. |
| `data.ticket.order_id` | integer |  |  |
| `data.ticket.order_reference` | string |  |  |
| `data.ticket.event_id` | integer |  |  |
| `data.ticket.date_id` | integer |  | The date the ticket is for. |
| `data.ticket.type_id` | integer |  |  |
| `data.ticket.type_name` | string |  | The ticket type's name as it was sold. |
| `data.ticket.role` | string |  | one of: `ticket`, `addon` |
| `data.ticket.seq` | integer |  | 1..n inside the order. |
| `data.ticket.status` | string |  | valid and blocked tickets hold a place; refunded, cancelled and transferred (passed on) are final.; one of: `valid`, `blocked`, `refunded`, `cancelled`, `transferred` |
| `data.ticket.holder_name` | string |  |  |
| `data.ticket.answers` | object |  | The answers given for this ticket: question id -> value.; any keys |
| `data.ticket.seat` | object |  | null without a seat. |
| `data.ticket.seat.key` | string |  | The key of the seat in the seat plan. |
| `data.ticket.seat.label` | string |  |  |
| `data.ticket.seat.section` | string |  |  |
| `data.ticket.seat.row` | string |  |  |
| `data.ticket.seat.seat` | string |  |  |
| `data.ticket.seat.table` | string |  |  |
| `data.ticket.admits` | integer |  |  |
| `data.ticket.check_in` | object |  | The check-in state of a ticket. |
| `data.ticket.check_in.people` | integer |  | People admitted so far (0 to admits). Above 0 = checked in. |
| `data.ticket.check_in.inside` | integer |  | People inside now, for events that count people leaving. |
| `data.ticket.check_in.entries` | integer |  | Accepted scans on the way in. |
| `data.ticket.check_in.first_at` | string |  |  |
| `data.ticket.check_in.last_at` | string |  |  |
| `data.ticket.check_in.last_out_at` | string |  |  |
| `data.ticket.check_in.gate` | string |  | The id of the entrance of the last scan. |
| `data.ticket.currency` | string |  |  |
| `data.ticket.price` | number |  | What was paid for this ticket, all in: what a refund of it returns. |
| `data.ticket.price_label` | string |  |  |
| `data.ticket.face` | number |  | The all-in list price before a discount. |
| `data.ticket.refunded` | number |  |  |
| `data.ticket.refunded_at` | string |  |  |
| `data.ticket.block_reason` | string |  | Why staff blocked it. A disputed payment reads Payment disputed. |
| `data.ticket.passed_on` | boolean |  | true: the ticket was made when a holder passed a ticket on. |
| `data.ticket.replaces_id` | integer |  | The ticket this one replaced. 0 = none. |
| `data.ticket.replaced_by_id` | integer |  | The ticket that replaced this one. 0 = none. |
| `data.ticket.page_url` | string |  | The ticket page of this ticket. Anyone who has the link can open the ticket: treat it like a password and give it only to the buyer. Empty in webhook events, for an erased order and for a ticket that is no longer valid. |
| `data.ticket.created` | string |  |  |
| `data.ticket.updated` | string |  |  |
| `data.ticket.buyer` | object |  | Only in the rows of GET /tickets/issued: who bought it. |
| `data.ticket.buyer.name` | string |  |  |
| `data.ticket.buyer.contact` | string |  |  |
| `data.ticket.buyer.email` | string |  |  |
| `data.order` | object | yes |  |
| `data.order.id` | integer |  | The order's id. |
| `data.order.reference` | string |  |  |
| `data.check_in` | object | yes |  |
| `data.check_in.id` | integer |  | The check-in's id. |
| `data.check_in.at` | string |  |  |
| `data.check_in.people` | integer |  | People admitted by this scan. |
| `data.check_in.gate` | string |  | The id of the entrance. |
| `data.check_in.method` | string |  | How it was scanned, eg camera, list or api. |
| `data.check_in.by` | string |  | Who scanned. |
| `data.timestamp` | string | yes |  |

## Samples

### first entry

```json
{
  "id": "evt_Tkt3k9m2Lw8Rt5Yp1Zs03",
  "type": "ticket.checked_in",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "ticket": {
      "id": 501,
      "order_id": 8812,
      "order_reference": "TK-7H3KQ9",
      "event_id": 12,
      "date_id": 31,
      "type_id": 44,
      "type_name": "Adult",
      "role": "ticket",
      "seq": 1,
      "status": "valid",
      "holder_name": "John Smith",
      "answers": {},
      "seat": null,
      "admits": 1,
      "check_in": {
        "people": 1,
        "inside": 1,
        "entries": 1,
        "first_at": "2026-11-06T01:00:00.000Z",
        "last_at": "2026-11-06T01:00:00.000Z",
        "last_out_at": null,
        "gate": "g1"
      },
      "currency": "AUD",
      "price": 0,
      "price_label": "A$0.00",
      "face": 12,
      "refunded": 0,
      "refunded_at": null,
      "block_reason": "",
      "passed_on": false,
      "replaces_id": 0,
      "replaced_by_id": 0,
      "page_url": "",
      "created": "2026-11-06T01:00:00.000Z",
      "updated": "2026-11-06T01:00:00.000Z"
    },
    "order": {
      "id": 8812,
      "reference": "TK-7H3KQ9"
    },
    "check_in": {
      "id": 90211,
      "at": "2026-11-06T01:00:00.000Z",
      "people": 1,
      "gate": "g1",
      "method": "camera",
      "by": "Sam"
    },
    "timestamp": "2026-11-06T01:00:00.000Z"
  }
}
```

## Caused by

- [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`
- [Check a ticket in (or out) by its code or id](https://www.app2email.com/docs/api/tickets-and-pay/check-in-ticket.md): `POST /v1/{number}/tickets/check-ins`

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