---
title: "Book Event"
method: POST
path: "/activity/{location_id}/{event_id}/book"
tags: ["Online Booking"]
---

# Book Event

`POST /activity/{location_id}/{event_id}/book`

## Request

- Base URL: `https://api.alteg.io/api/v1`
- URL: `https://api.alteg.io/api/v1/activity/{location_id}/{event_id}/book`
- Auth: HTTP bearer

## Path parameters

- `location_id` number, required
- `event_id` integer, required

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Request body `*/*`

- EventBookRequest: Book Event request body
  - `fullname` string, required: Client name
  - `phone` string, required: Customer phone (for example +13155550175)
  - `email` string, required: Postal address of the client
  - `national_id` string: Client IIN — 12 digits with a valid check digit. Accepted only for locations in Kazakhstan and ignored for other countries. Optional: when omitted or empty, the IIN already saved for the client is left unchanged.
  - `code` number: SMS confirmation code for verifying the phone number. This field is required if the location has phone_confirmation = true
  - `comment` string: Appointment Comment
  - `notify_by_sms` integer: Specifies how many hours in advance an SMS reminder should be sent before the appointment. Set to 0 to disable SMS reminders.
  - `notify_by_email` integer: Specifies how many hours in advance an email reminder should be sent before the appointment. Set to 0 to disable email reminders
  - `type` string: Appointment source
  - `api_id` number: Appointment ID from external system
  - `clients_count` number: number of seats

## Response `200`

OK

- EventBookResponse: Book Event response with created Appointment details
  - `success` boolean: Execution success status (true)
  - `data` object: Object with data
    - `id` integer: Appointment ID
    - `hash` string: Appointment ID, for deleting it immediately after creation
  - `meta` object[]: Metadata (empty array)

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-09-10** `4262beaa6cfe`: 1 info
  - added the new optional request property `national_id`

[Operation history](https://skmtc.dev/alteg/apis/online-booking/changes/activity/:location_id/:event_id/book/post.md)

---

[API](https://skmtc.dev/alteg/apis/online-booking.md) - [All operations](https://skmtc.dev/alteg/apis/online-booking/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/online-booking/revisions/5219afc665ea?raw)