Check-ins

Scan tickets in and out from your own door app, with gates and re-entry.

Scan a ticket

POST/api/v1/events/{id}/check-ins

The same check-in as the EOS scanner: each ticket once, gates, exits and re-entry, age and staff passes. Send what the QR says, the ticket code, or a link to the ticket.

Permissioncheckins:write (Check guests in)
Publishable keyNo: secret keys only

Path parameters

idintegerRequired
The event's id.

Body (JSON)

codestringRequired
What was scanned or typed.
gatestring
The gate's id, from the event's gates. Defaults to the first gate.
modestring
entry (default) or exit.entryexit
paid_at_doorboolean
For a ticket paid at the door: the door has taken its price. Send it with the same code after a payment_due answer; the payment is recorded and the guest let in.

Errors it can give

  • 404not_foundNo such object in this company.
  • 409not_scannableThe event has no door list yet. Set one up in EOS.
  • 422plan_limitThe plan's devices are all scanning: each API key that checks guests in counts as one device, as a phone does.
Request
curl -X POST "https://eos.aveoevents.com/api/v1/events/41/check-ins" \
  -H "Authorization: Bearer $EOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"A-7Q2KX9","gate":"main"}'
200 response
{
  "object": "check_in",
  "event_id": 41,
  "attendee_id": "A-7Q2KX9",
  "result": "admitted",
  "ok": true,
  "message": "Admit",
  "name": "Sam Taylor",
  "ticket_type": "General admission",
  "gate": "Main entrance",
  "mode": "entry",
  "age": 27,
  "note": null,
  "addons": [
    "Cloakroom"
  ],
  "first_scan": null,
  "door_payment": null,
  "created_at": "2026-12-05T19:02:11.000Z"
}

Every field of the response: the check in object.

List check-ins

GET/api/v1/events/{id}/check-ins

Every scan at the event's doors, newest first.

Permissioncheckins:read (Read check-ins)
Publishable keyNo: secret keys only
ListsPaged with limit and cursor. Pagination

Path parameters

idintegerRequired
The event's id.

Query parameters

limitinteger
How many to return, 1 to 100. Default 25.
cursorstring
The next_cursor from the previous page.

Errors it can give

Request
curl "https://eos.aveoevents.com/api/v1/events/41/check-ins" \
  -H "Authorization: Bearer $EOS_API_KEY"
200 response
{
  "object": "list",
  "url": "/api/v1/events/41/check-ins",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "object": "check_in",
      "event_id": 41,
      "attendee_id": "A-7Q2KX9",
      "result": "admitted",
      "ok": true,
      "message": "Admit",
      "name": "Sam Taylor",
      "ticket_type": "General admission",
      "gate": "Main entrance",
      "mode": "entry",
      "age": 27,
      "note": null,
      "addons": [
        "Cloakroom"
      ],
      "first_scan": null,
      "door_payment": null,
      "created_at": "2026-12-05T19:02:11.000Z"
    }
  ]
}

Every field of the response: the check in object.