Check-in Online
Perform online check-in for a booking (PNR) if supported by the airline and system. This endpoint allows you to initiate the check-in process for eligible bookings.
Endpoint
- URL:
/api/v1/flight/checkin-online - Method:
POST - Auth Required: Yes (Bearer Token/X-API-KEY)
- Content-Type:
application/json
Authentication
This endpoint requires a valid JWT Bearer token in the Authorization header:
Authorization: Bearer <access_token>
Obtain tokens via /api/v1/sign-in (POST) with your credentials.
Request Structure
| Field | Type | Required | Description |
|---|---|---|---|
| system | string | Yes | Booking system code |
Sample Request:
{
"system": "VN"
}
Request Constraints & Business Rules
- Only bookings and airlines that support online check-in can use this endpoint.
- The booking must be in a state eligible for check-in (e.g., ticketed, not canceled).
- The
systemfield should match the booking's system code. - Check-in windows and rules are subject to airline and system policies.
Response Structure
| Field | Type | Nullable | Description |
|---|---|---|---|
| system | string | Yes | System name (e.g., VN, VJ) |
| status | boolean | No | true if successful, false if failed |
| error | object | Yes | Error code object |
| description | string | Yes | Error message or status description |
| trackingId | string | Yes | Request tracking ID |
| trackingTime | string | Yes | Request tracking timestamp |
Sample Response:
{
"system": "VN",
"status": true,
"description": "Check-in successful",
"trackingId": "abc-123",
"trackingTime": "2024-06-01T12:00:00Z"
}
Error Codes
This endpoint may return the following error codes:
- 35000 - Check-in Online: Errors specific to online check-in operations (35000)
- 00000 - Flight Hub (General Errors): General system and authentication errors (00001-00056)
For a complete list of error codes, see Error Codes.
Security & Validation
- All input is validated for type and required fields.
- Only authenticated users can access this endpoint.
- All actions are logged and traceable.
Validation Questions
- What are the allowed states for a booking to be checked in?
- Are there restrictions on which airlines or systems support online check-in?
- What happens if the booking is not eligible for check-in?
For integration support, see Contact Support.