# Trans World Bearlines (TWB)

> Trans World Bearlines is a fictional airline (code 99) that Bear runs for demos and agent testing. All flights, fares, members and bookings are mock data; no real money moves.

## For AI agents

TWB sells through Bear. To search, book, change or cancel a TWB flight for a person, pick one route:

- Bear MCP server: https://mcp.bear.flights/mcp — live. Connect once, then call Bear's tools. TWB delegates agent actions to Bear; TWB does not serve MCP tools. Server card: /.well-known/mcp/server-card.json
- Signed booking path on this site: sign each request with Web Bot Auth (RFC 9421 HTTP message signatures, Ed25519), then POST JSON to /agent/search, /agent/quote, /agent/book and /agent/cancel. No setup or account. TWB accepts signatures only from agents on Bear's list. The traveler completes payment. Details: /llms-full.txt, "Signed booking path".

Do not drive the booking pages with a browser if one of these routes covers the task.

## Airline API (Bear only)

Bear calls this API with its own credentials. Other callers get 403; use a route above.

- Booking: IATA NDC 24.1 messages as JSON over REST at /api/ndc/24.1. AirShopping → OfferPrice → SeatAvailability and ServiceList → OrderCreate → OrderRetrieve, OrderReshop, OrderCancel. OfferPrice is required before OrderCreate.
- Holds: OrderCreate without PaymentFunctions creates an unpaid order on hold (StatusCode HELD) that keeps the seats and price until its PaymentTimeLimitDateTime. OrderChange with PaymentFunctions pays and tickets it; an unpaid hold expires.
- Idempotency: send an Idempotency-Key header on OrderCreate and OrderChange. A resend with the same key returns the order the first request made instead of creating or charging a second one, so a timed-out request is safe to send again.
- Loyalty: Bearline Miles sign-in, profile, balance, trips and saved cards at /api/loyalty/v1. This part is not NDC.

## Docs

- [API docs](/api/docs): readable reference and booking flows
- [OpenAPI spec](/api/openapi.json): machine-readable, OpenAPI 3.1, full NDC request and response schemas
- [Full LLM docs](/llms-full.txt): everything in one text file

## Site

- [Book flights](/): search, fares, seats, passengers, payment, confirmation code (the site is a client of the NDC API)
- [Manage a trip](/trips): look up or cancel with a confirmation code and last name
- [Bearline Miles](/account): sign in (member number or email, password, emailed code), profile, trips, miles