# Jinko Platform

> Connect your AI agent to flight discovery, live pricing, trips, and booking through MCP, REST API, or CLI.

## Docs

- [API reference](https://docs.gojinko.com/api-reference/introduction.md): The canonical reference for the Jinko Public API — request/response schemas, examples, and a try-it playground for every endpoint.
- [book](https://docs.gojinko.com/api/book.md): Schedule checkout for a trip — returns a checkout URL the user opens to complete payment
- [exchange commit](https://docs.gojinko.com/api/exchange/commit.md): Commit a flight exchange
- [exchange price](https://docs.gojinko.com/api/exchange/price.md): Price a specific exchange offer
- [exchange shop](https://docs.gojinko.com/api/exchange/shop.md): Shop for flight exchange alternatives
- [exchange status](https://docs.gojinko.com/api/exchange/status.md): Check the status of an exchange
- [find-dates](https://docs.gojinko.com/api/find-dates.md): Best date options for a route — up to ten cheapest itineraries, one per date-pair, spread across the month
- [find-destination](https://docs.gojinko.com/api/find-destination.md): Discover travel destinations accessible from your departure airports
- [flight-calendar](https://docs.gojinko.com/api/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [flight-search](https://docs.gojinko.com/api/flight-search.md): Get live flight pricing — search by route, or re-price a known offer
- [get-booking](https://docs.gojinko.com/api/get-booking.md): Retrieve a booking using the Jinko booking reference and the traveler's last name
- [hotel-cancel](https://docs.gojinko.com/api/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [hotel-details](https://docs.gojinko.com/api/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [hotel-search](https://docs.gojinko.com/api/hotel-search.md): Search live hotel inventory and rates
- [lowest-fare](https://docs.gojinko.com/api/lowest-fare.md): Cheapest fares for a fixed route + date — up to ten itineraries, cheapest first
- [price-monitoring](https://docs.gojinko.com/api/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [refund check](https://docs.gojinko.com/api/refund/check.md): Check refund eligibility and estimated amount
- [refund commit](https://docs.gojinko.com/api/refund/commit.md): Initiate a refund for a booked flight
- [refund status](https://docs.gojinko.com/api/refund/status.md): Check the status of a refund
- [select-ancillaries](https://docs.gojinko.com/api/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [trip](https://docs.gojinko.com/api/trip.md): Create and manage a trip — add or remove items, set travelers, select ancillaries
- [trip-status](https://docs.gojinko.com/api/trip-status.md): Fetch the full lifecycle state of a trip — items, travelers, quote, fulfillment, and any booking references
- [trip ancillaries](https://docs.gojinko.com/api/trip/ancillaries.md): List purchasable ancillaries for a trip (no checkout)
- [webhooks](https://docs.gojinko.com/api/webhooks.md): Delete a webhook subscription
- [webhooks test](https://docs.gojinko.com/api/webhooks/test.md): Send a sample signed event to validate the endpoint
- [API keys](https://docs.gojinko.com/authentication/api-keys.md): Get and use API keys (jnk_*) for programmatic access to Jinko.
- [OAuth](https://docs.gojinko.com/authentication/oauth.md): Browser-based auth for MCP clients (DCR) and the CLI (device flow).
- [jinko auth login](https://docs.gojinko.com/cli/auth/login.md): Authenticate with Jinko (OAuth or API key).
- [jinko auth logout](https://docs.gojinko.com/cli/auth/logout.md): Clear stored credentials.
- [jinko auth status](https://docs.gojinko.com/cli/auth/status.md): Show current authentication status.
- [jinko book](https://docs.gojinko.com/cli/book.md): Schedule checkout for a trip — returns a checkout URL the user opens to complete payment
- [jinko config set](https://docs.gojinko.com/cli/config/set.md): Set a config value. Keys: api_key, environment
- [jinko config show](https://docs.gojinko.com/cli/config/show.md): Show current configuration.
- [jinko exchange commit](https://docs.gojinko.com/cli/exchange/commit.md): Commit a flight exchange
- [jinko exchange price](https://docs.gojinko.com/cli/exchange/price.md): Price a specific exchange offer
- [jinko exchange shop](https://docs.gojinko.com/cli/exchange/shop.md): Shop for flight exchange alternatives
- [jinko exchange status](https://docs.gojinko.com/cli/exchange/status.md): Check the status of an exchange
- [jinko find-dates](https://docs.gojinko.com/cli/find-dates.md): Best date options for a route — up to ten cheapest itineraries, one per date-pair, spread across the month
- [jinko find-destination](https://docs.gojinko.com/cli/find-destination.md): Discover travel destinations accessible from your departure airports
- [jinko flight-calendar](https://docs.gojinko.com/cli/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [jinko flight-search](https://docs.gojinko.com/cli/flight-search.md): Get live flight pricing — search by route, or re-price a known offer
- [jinko get-booking](https://docs.gojinko.com/cli/get-booking.md): Retrieve a booking using the Jinko booking reference and the traveler's last name
- [jinko hotel-cancel](https://docs.gojinko.com/cli/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [jinko hotel-details](https://docs.gojinko.com/cli/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [jinko hotel-search](https://docs.gojinko.com/cli/hotel-search.md): Search live hotel inventory and rates
- [jinko lowest-fare](https://docs.gojinko.com/cli/lowest-fare.md): Cheapest fares for a fixed route + date — up to ten itineraries, cheapest first
- [Overview](https://docs.gojinko.com/cli/overview.md): The canonical reference for the Jinko CLI — every command, its flags, and examples. Run flight discovery, live pricing, trips, and booking from your shell.
- [jinko price-monitoring](https://docs.gojinko.com/cli/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [jinko refund check](https://docs.gojinko.com/cli/refund/check.md): Check refund eligibility and estimated amount
- [jinko refund commit](https://docs.gojinko.com/cli/refund/commit.md): Initiate a refund for a booked flight
- [jinko refund status](https://docs.gojinko.com/cli/refund/status.md): Check the status of a refund
- [jinko schema](https://docs.gojinko.com/cli/schema.md): Show request/response schema for a command. List all if no command given.
- [jinko select-ancillaries](https://docs.gojinko.com/cli/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [jinko trip](https://docs.gojinko.com/cli/trip.md): Create and manage a trip — add or remove items, set travelers, select ancillaries
- [jinko trip-status](https://docs.gojinko.com/cli/trip-status.md): Fetch the full lifecycle state of a trip — items, travelers, quote, fulfillment, and any booking references
- [Ancillaries](https://docs.gojinko.com/concepts/ancillaries.md): Baggage, seats, meals and other add-ons on a flight — how to read available_ancillaries and select them
- [Errors & troubleshooting](https://docs.gojinko.com/concepts/errors.md): HTTP status codes, error envelope, and what to do when things go sideways.
- [LLMs.txt](https://docs.gojinko.com/concepts/llms-txt.md): Machine-readable documentation entry points for AI agents.
- [Concepts](https://docs.gojinko.com/concepts/overview.md): Trip, quote, fulfillment, the mental model for Jinko's booking flow.
- [Rate Limits](https://docs.gojinko.com/concepts/rate-limits.md): Current Jinko platform rate limits.
- [CLI](https://docs.gojinko.com/connect/cli.md): Install the Jinko CLI and run the booking flow from your shell.
- [MCP](https://docs.gojinko.com/connect/mcp.md): Connect OAuth-capable MCP clients to Jinko over the remote endpoint.
- [TypeScript SDK](https://docs.gojinko.com/connect/sdk.md): @gojinko/api-client, typed wrapper around the Jinko REST API.
- [Skills](https://docs.gojinko.com/connect/skills.md): Prebuilt prompts + workflows that make coding agents better at using Jinko.
- [Flight booking](https://docs.gojinko.com/guides/flight-booking.md): Discover, price, build, and book a real flight, with side-by-side examples for SDK, CLI, and MCP.
- [Flight + Hotel booking](https://docs.gojinko.com/guides/flight-hotel-booking.md): One trip, two items, one Stripe checkout. Add a flight and a hotel to the same trip and book them together.
- [Hotel booking](https://docs.gojinko.com/guides/hotel-booking.md): Discover, build, and book a real hotel stay, with side-by-side examples for SDK, CLI, and MCP.
- [Webhooks](https://docs.gojinko.com/guides/webhooks.md): Get notified when bookings complete or fail — register a callback, verify the signature, handle the event.
- [Jinko Platform](https://docs.gojinko.com/introduction.md): Build agents that discover, price, book, and manage travel products.
- [How to Connect](https://docs.gojinko.com/quickstart.md): Connect your AI agent to Jinko in under 2 minutes.
- [Book Trip](https://docs.gojinko.com/tools/book.md): Schedule checkout for a trip — returns a checkout URL the user opens to complete payment
- [Find Dates](https://docs.gojinko.com/tools/find-dates.md): Best date options for a route — up to ten cheapest itineraries, one per date-pair, spread across the month
- [Find Destination](https://docs.gojinko.com/tools/find-destination.md): Discover travel destinations accessible from your departure airports
- [Flight Calendar](https://docs.gojinko.com/tools/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [Flight Exchange](https://docs.gojinko.com/tools/flight-exchange.md): Exchange a booked flight for a different itinerary
- [Flight Refund](https://docs.gojinko.com/tools/flight-refund.md): Check refund eligibility, commit a refund, or check refund status for a booked flight
- [Flight Search](https://docs.gojinko.com/tools/flight-search.md): Get live flight pricing — search by route, or re-price a known offer
- [Get Booking](https://docs.gojinko.com/tools/get-booking.md): Retrieve a booking using the Jinko booking reference and the traveler's last name
- [Get Trip](https://docs.gojinko.com/tools/get-trip.md): Fetch the full lifecycle state of a trip — items, travelers, quote, fulfillment, and any booking references
- [Cancel Hotel Booking](https://docs.gojinko.com/tools/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [Hotel Details](https://docs.gojinko.com/tools/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [Hotel Search](https://docs.gojinko.com/tools/hotel-search.md): Search live hotel inventory and rates
- [Lowest Fare](https://docs.gojinko.com/tools/lowest-fare.md): Cheapest fares for a fixed route + date — up to ten itineraries, cheapest first
- [Overview](https://docs.gojinko.com/tools/overview.md): The canonical reference for Jinko's MCP tools — what each tool does, its input schema, and examples. Connect any OAuth-capable MCP client to the remote endpoint.
- [Price Monitoring](https://docs.gojinko.com/tools/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [Trip](https://docs.gojinko.com/tools/trip.md): Create and manage a trip — add or remove items, set travelers, select ancillaries

## OpenAPI Specs

- [public-api](https://docs.gojinko.com/api-reference/public-api.yaml)
- [openapi](https://docs.gojinko.com/api-reference/openapi.json)