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.
Permission
checkins: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.
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"}'{
"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.
Permission
checkins: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
- 404not_foundNo such object in this company.
curl "https://eos.aveoevents.com/api/v1/events/41/check-ins" \
-H "Authorization: Bearer $EOS_API_KEY"{
"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.