> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pageonetravel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Base conventions and important runtime behavior.

## Base URL

Use the host provided by PageOne Travel:

```bash theme={null}
https://<your-host>/api
```

All routes in this documentation are shown with `/api` prefix.

## Content Type

Use `application/json` for request and response payloads.

## Success Response Envelope

Backend applies a global response interceptor, so successful calls return:

```json theme={null}
{
  "data": {},
  "message": "success"
}
```

## Error Response

Error responses are standard NestJS HTTP errors (not wrapped by `data/message` envelope), for example:

```json theme={null}
{
  "statusCode": 400,
  "message": "Price changed",
  "error": "Bad Request"
}
```

## Required Date/Time Formats

* Date fields (`checkIn`, `checkOut`): `YYYY-MM-DD`
* Cancellation penalty deadlines: ISO-8601 datetime string

## Important Runtime Behavior

* `session-id` header: auto-generated by backend if missing.
* `connection-code` header: auto-filled from `settings.access.code` when available.
* Search/Quote have rate limiting with response headers:
  * `X-RateLimit-Limit`
  * `X-RateLimit-Remaining`
  * `X-RateLimit-Reset`
  * `Retry-After` (when limited)

## API Index

* Authentication: `/api-reference/authentication`
* Flow sequence: `/api-reference/workflow`
* Core APIs: `/api-reference/core/search`, `/api-reference/core/quote`, `/api-reference/core/book`, `/api-reference/core/cancel`
* Content API: `/api-reference/content/accommodations`
* Partner management: `/api-reference/management/auth-login`, `/api-reference/management/users`, `/api-reference/management/api-keys`, `/api-reference/management/partner-connections`
* Shared object models: `/api-reference/models/common-objects`