# Jinko Platform

> Connect your AI agent to flights, hotels, car rentals, and bookings through MCP, REST API, TypeScript SDK, or CLI.

- [Introduction](https://docs.gojinko.com/introduction.md): The end-to-end travel rails between agents and suppliers.
- [Quickstart](https://docs.gojinko.com/quickstart.md): Set up Jinko yourself or hand the setup to your agent.
- [Flights](https://docs.gojinko.com/guides/flight-booking.md): Discover, search, book, and manage flights with Jinko.
- [Hotels](https://docs.gojinko.com/guides/hotel-booking.md): Search, compare, book, and manage hotel stays with Jinko.
- [Car rentals](https://docs.gojinko.com/guides/car-rental-booking.md): Search, compare, book, and manage car rentals with Jinko.
- [Ancillaries](https://docs.gojinko.com/concepts/ancillaries.md): Find, select, and manage flight add-ons, car rental extras, and hotel options with Jinko.
- [Seats](https://docs.gojinko.com/concepts/ancillaries/seats.md): Find, choose, and manage flight seats with Jinko.
- [Bags](https://docs.gojinko.com/concepts/ancillaries/bags.md): Check included baggage, select extra bags, and follow booking outcomes with Jinko.
- [Trips and checkout](https://docs.gojinko.com/guides/trips-and-checkout.md): Add flights, hotels, and car rentals to one trip, then check out with one payment.
- [Payments](https://docs.gojinko.com/guides/payments.md): How checkout lists the ways to pay for a trip, and which one to use.
- [Checkout link](https://docs.gojinko.com/guides/checkout-link.md): Send the traveler to a page Jinko hosts to review the trip and pay.
- [Shared Payment Token](https://docs.gojinko.com/guides/shared-payment-token.md): Let your agent platform pay for the trip programmatically with a token scoped to the checkout.
- [Card payments](https://docs.gojinko.com/guides/partner-card-payments.md): Submit a customer card or a virtual credit card (VCC) from your backend, and handle the outcomes specific to cards.
- [Payment outcomes and retries](https://docs.gojinko.com/guides/payment-outcomes.md): Pay the quote the traveler approved, retry without paying twice, and follow the recovery action of every payment you submit.
- [Hotel AI search](https://docs.gojinko.com/ai/hotel-search/overview.md): Search hotels from the traveler's own words over REST: send one sentence, answer the questions it asks, refine with follow-ups, and book a result.
- [Conversations](https://docs.gojinko.com/ai/hotel-search/conversations.md): Answer the questions a hotel AI search asks, refine a search with follow-ups, change it while it runs, and know when a conversation expires.
- [Waiting for results](https://docs.gojinko.com/ai/hotel-search/waiting-for-results.md): Get the answer of a hotel AI search in one call, by reading the task, or as a stream of events; cancel a search and retry a message safely.
- [Statuses and errors](https://docs.gojinko.com/ai/hotel-search/statuses-and-errors.md): What each status of a hotel AI search task means, why a search fails, and how to handle each HTTP status of the four routes.
- [Flight AI search](https://docs.gojinko.com/ai/flight-search/overview.md): Search flights from the traveler's own words over REST: send one sentence, answer the questions it asks, refine with follow-ups, and book a fare.
- [Conversations](https://docs.gojinko.com/ai/flight-search/conversations.md): Answer the questions a flight AI search asks, refine a search with follow-ups, change it while it runs, and know when a conversation expires.
- [Waiting for results](https://docs.gojinko.com/ai/flight-search/waiting-for-results.md): Get the answer of a flight AI search by reading the task or as a stream of events; cancel a search and retry a message safely.
- [Statuses and errors](https://docs.gojinko.com/ai/flight-search/statuses-and-errors.md): What each status of a flight AI search task means, why a search fails, and how to handle each HTTP status of the four routes.
- [Best price guarantee](https://docs.gojinko.com/marketing-claims/best-price-guarantee.md): Let an AI agent find a lower rate and ask Jinko to match it.
- [Price Advice](https://docs.gojinko.com/marketing-claims/price-advice.md): Help travelers decide whether to book a flight now or wait for a better price.
- [Price Drop Protection](https://docs.gojinko.com/marketing-claims/price-drop-protection.md): Monitor a confirmed hotel booking and rebook it when the same room costs less.
- [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 OAuth for MCP clients, REST bearer authentication, and API keys for the CLI.
- [AI agent self-registration](https://docs.gojinko.com/authentication/agent-registration.md): An AI agent's own organization and API key, with an optional human claim.
- [MCP](https://docs.gojinko.com/connect/mcp.md): Connect an MCP client to Jinko and read tool results correctly.
- [TypeScript SDK](https://docs.gojinko.com/connect/sdk.md): @gojinko/api-client, typed wrapper around the Jinko REST API.
- [CLI](https://docs.gojinko.com/connect/cli.md): Install the Jinko CLI and run the booking flow from your shell.
- [Skills](https://docs.gojinko.com/connect/skills.md): Guide a model through Jinko's travel tools and workflows.
- [Webhooks](https://docs.gojinko.com/guides/webhooks.md): Receive signed booking and servicing events without polling.
- [Send your own customer emails](https://docs.gojinko.com/guides/send-your-own-emails.md): Use Jinko webhook data to send booking emails in your own brand.
- [Auto top-up](https://docs.gojinko.com/guides/auto-top-up.md): Automatically add prepaid credit when your API balance runs low.
- [Booking Life Cycle](https://docs.gojinko.com/concepts/overview.md): How Jinko moves from search to a confirmed booking.
- [Errors & troubleshooting](https://docs.gojinko.com/concepts/errors.md): The closed error-code enum, the failure envelope, and the remedy for every code the platform can send.
- [LLM-friendly docs](https://docs.gojinko.com/concepts/llms-txt.md): Read Jinko documentation as Markdown, OpenAPI, or through the public documentation MCP.
- [Limits & credits](https://docs.gojinko.com/concepts/rate-limits.md): What gates an API call: prepaid credit in US dollars, and a per-second request ceiling.
- [Versioning & deprecation](https://docs.gojinko.com/concepts/versioning.md): How the public contract changes, what counts as breaking, and how much warning you get.
- [Changelog](https://docs.gojinko.com/changelog.md): Every version of the public REST contract since 0.57.0, newest first: what was added, changed, deprecated or removed.
- [Overview](https://docs.gojinko.com/tools/overview.md): What you can do with the Jinko MCP server and how to connect your AI agent to it: search flights, hotels, and rental cars, build a trip, pay, and manage bookings from inside a conversation.
- [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
- [Find Dates](https://docs.gojinko.com/tools/find-dates.md): Best date options for a route, the cheapest itinerary per date-pair, spread across the departure window
- [Price Monitoring](https://docs.gojinko.com/tools/price-monitoring.md): Get one cached price snapshot for a specific route and date pair
- [Flight Price Advice](https://docs.gojinko.com/tools/flight-price-advice.md): Accept a flight with its current price for price advice
- [Flight Search](https://docs.gojinko.com/tools/flight-search.md): Get live flight pricing, search by route, or re-price a known offer
- [Flight Refund](https://docs.gojinko.com/tools/flight-refund.md): Cancels a booked flight, refunding tickets or voiding them inside the airline's void window
- [Flight Exchange](https://docs.gojinko.com/tools/flight-exchange.md): Exchanges a booked flight for a different itinerary
- [Hotel Search](https://docs.gojinko.com/tools/hotel-search.md): Search live hotel inventory and rates
- [Hotel Details](https://docs.gojinko.com/tools/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [Hotel Reviews](https://docs.gojinko.com/tools/hotel-reviews.md): Fetch the guest review summary, per-category scores and recent reviews for a single hotel
- [Cancel Hotel Booking](https://docs.gojinko.com/tools/hotel-cancel.md): Preview a hotel cancellation, then cancel it
- [Search Car Rentals](https://docs.gojinko.com/tools/car-search.md): Live car rental availability between a pick-up and a drop-off place, priced and bookable
- [Cancel Car Rental Booking](https://docs.gojinko.com/tools/car-cancel.md): Preview the cancellation fee, cancel a car rental, or re-read the latest attempt
- [Trip](https://docs.gojinko.com/tools/trip.md): Create and manage a trip, add or remove items, set travelers, select ancillaries
- [Checkout Trip](https://docs.gojinko.com/tools/checkout.md): Checkout a trip, returns a checkout URL the user opens to pay, plus agent payment params
- [Submit Agent Payment](https://docs.gojinko.com/tools/submit-agent-payment.md): Redeem a Shared Payment Token to authorize the booking server-side
- [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
- [Get Booking](https://docs.gojinko.com/tools/get-booking.md): Look up a booking and choose the item to service
- [Claim the Best Price Guarantee](https://docs.gojinko.com/tools/claim-best-price-guarantee.md): Ask for a hotel offer at a lower price found elsewhere
- [Read a Best Price Guarantee claim](https://docs.gojinko.com/tools/get-best-price-guarantee.md): Read the result of a claim
- [Overview](https://docs.gojinko.com/cli/overview.md): What you can do with the Jinko CLI and how to run it from your shell: explore travel demand, search flights, hotels, and rental cars, build a trip, pay, and manage bookings.
- [jinko travel-demand destination](https://docs.gojinko.com/cli/travel-demand/destination.md): Top destinations by search demand
- [jinko travel-demand destination-trend](https://docs.gojinko.com/cli/travel-demand/destination-trend.md): Demand time series for the top-N destinations
- [jinko travel-demand market](https://docs.gojinko.com/cli/travel-demand/market.md): Top source markets for a destination
- [jinko travel-demand market-trend](https://docs.gojinko.com/cli/travel-demand/market-trend.md): Demand time series for the top-N source markets
- [jinko travel-demand audience](https://docs.gojinko.com/cli/travel-demand/audience.md): Traveler-type mix for a destination
- [jinko travel-demand audience-trend](https://docs.gojinko.com/cli/travel-demand/audience-trend.md): Demand time series for the traveler-type mix
- [jinko travel-demand trend](https://docs.gojinko.com/cli/travel-demand/trend.md): Demand time series for explicit origin/destination pairs
- [jinko find-destination](https://docs.gojinko.com/cli/find-destination.md): Discover travel destinations using cached flight fares for one adult
- [jinko flight-calendar](https://docs.gojinko.com/cli/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [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 lowest-fare](https://docs.gojinko.com/cli/lowest-fare.md): Cheapest fares for a fixed route + date, up to ten itineraries, cheapest first
- [jinko price-monitoring](https://docs.gojinko.com/cli/price-monitoring.md): Get one cached price snapshot for a specific route and date pair
- [jinko flight-price-advice](https://docs.gojinko.com/cli/flight-price-advice.md): Accept a flight with its current price for price advice
- [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 refund check](https://docs.gojinko.com/cli/refund/check.md): Check refund eligibility (deprecated: use refund preview)
- [jinko refund preview](https://docs.gojinko.com/cli/refund/preview.md): Preview the customer's refund and penalty before committing
- [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 exchange shop](https://docs.gojinko.com/cli/exchange/shop.md): Shop for flight exchange alternatives
- [jinko exchange price](https://docs.gojinko.com/cli/exchange/price.md): Price a specific exchange offer
- [jinko exchange commit](https://docs.gojinko.com/cli/exchange/commit.md): Commit a flight exchange
- [jinko exchange status](https://docs.gojinko.com/cli/exchange/status.md): Check the status of an exchange
- [jinko hotel-search](https://docs.gojinko.com/cli/hotel-search.md): Search live hotel inventory and rates
- [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-cancel preview](https://docs.gojinko.com/cli/hotel-cancel/preview.md): Quote the refund and penalty before cancelling a hotel
- [jinko hotel-cancel commit](https://docs.gojinko.com/cli/hotel-cancel/commit.md): Cancel a hotel at the refund the customer agreed to
- [jinko hotel-cancel status](https://docs.gojinko.com/cli/hotel-cancel/status.md): Check how a hotel cancellation and its refund are going
- [jinko car-search](https://docs.gojinko.com/cli/car-search.md): Search live car-rental offers
- [jinko car-cancel preview](https://docs.gojinko.com/cli/car-cancel/preview.md): Quote the cancellation fee for a car rental
- [jinko car-cancel commit](https://docs.gojinko.com/cli/car-cancel/commit.md): Cancel a booked car rental
- [jinko car-cancel status](https://docs.gojinko.com/cli/car-cancel/status.md): Check the status of a car-rental cancellation
- [jinko trip](https://docs.gojinko.com/cli/trip.md): Create and manage a trip, add or remove items, set travelers
- [jinko get-ancillaries](https://docs.gojinko.com/cli/get-ancillaries.md): List purchasable ancillaries for a trip (bags, seats, meals), no checkout URL
- [jinko select-ancillaries](https://docs.gojinko.com/cli/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [jinko checkout](https://docs.gojinko.com/cli/checkout.md): Checkout a trip, returns a checkout URL the user opens to pay, plus agent payment params
- [jinko agent-pay submit](https://docs.gojinko.com/cli/agent-pay/submit.md): Submit a Shared Payment Token to schedule + authorize the booking
- [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
- [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 best-price-guarantee claim](https://docs.gojinko.com/cli/best-price-guarantee/claim.md): Claim a matched price for a hotel offer
- [jinko best-price-guarantee get](https://docs.gojinko.com/cli/best-price-guarantee/get.md): Read a Best Price Guarantee request by id
- [jinko auth login](https://docs.gojinko.com/cli/auth/login.md): Authenticate with a Jinko API key (jnk_...). Get one from dashboard.gojinko.com → Developers → API keys.
- [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 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 schema](https://docs.gojinko.com/cli/schema.md): Show a bundled request/response schema. List available schemas if no command is given. Not every CLI command has a bundled schema.
- [API reference](https://docs.gojinko.com/api-reference/introduction.md): What the Jinko API offers and how to call it: explore travel demand, search flights, hotels, and rental cars, build a trip, pay, and manage bookings over HTTP.
- [destination](https://docs.gojinko.com/api/destination.md): Rank the top destinations by travel demand
- [destination trend](https://docs.gojinko.com/api/destination/trend.md): Demand time series for the top-N destinations
- [market](https://docs.gojinko.com/api/market.md): Rank origin markets feeding a destination
- [market trend](https://docs.gojinko.com/api/market/trend.md): Demand time series for the top-N source markets
- [audience](https://docs.gojinko.com/api/audience.md): Rank traveler audiences for a destination
- [audience trend](https://docs.gojinko.com/api/audience/trend.md): Demand time series per traveler-type segment
- [trend](https://docs.gojinko.com/api/trend.md): Demand time series for explicit origin/destination pairs
- [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
- [find-dates](https://docs.gojinko.com/api/find-dates.md): Best date options for a route, the cheapest itinerary per date pair, spread across the window
- [lowest-fare](https://docs.gojinko.com/api/lowest-fare.md): Cheapest fares for a fixed route + date, up to `limit` itineraries, cheapest first
- [price-monitoring](https://docs.gojinko.com/api/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [flight-price-advice](https://docs.gojinko.com/api/flight-price-advice.md): Accept a flight with its current price for price advice
- [flight-search](https://docs.gojinko.com/api/flight-search.md): Get live flight pricing, search by route, or re-price a known offer
- [refund check](https://docs.gojinko.com/api/refund/check.md): DEPRECATED, use /v1/flight_refund_preview. Check refund eligibility only; use flight_refund_preview for customer-facing amounts
- [refund commit](https://docs.gojinko.com/api/refund/commit.md): DEPRECATED, use /v1/flight_refund_commit. Initiate a refund for a booked flight
- [refund status](https://docs.gojinko.com/api/refund/status.md): DEPRECATED, use /v1/flight_refund_status. Check the status of a refund
- [exchange shop](https://docs.gojinko.com/api/exchange/shop.md): Shop for flight exchange alternatives
- [exchange price](https://docs.gojinko.com/api/exchange/price.md): Price a specific exchange offer
- [exchange commit](https://docs.gojinko.com/api/exchange/commit.md): Commit a flight exchange
- [exchange status](https://docs.gojinko.com/api/exchange/status.md): Check the status of an exchange
- [flight-refund-preview](https://docs.gojinko.com/api/flight-refund-preview.md): Preview what cancelling a booked flight (every ticket on the item) would return to the customer
- [flight-refund-commit](https://docs.gojinko.com/api/flight-refund-commit.md): Refund or void a booked flight (every ticket on the item) against a quote the customer accepted
- [flight-refund-status](https://docs.gojinko.com/api/flight-refund-status.md): Check how a flight refund or void ended
- [hotel-search](https://docs.gojinko.com/api/hotel-search.md): Search live hotel inventory and rates
- [hotel-details](https://docs.gojinko.com/api/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [hotel-reviews](https://docs.gojinko.com/api/hotel-reviews.md): Guest review summary and recent reviews for a single hotel
- [hotel-cancel](https://docs.gojinko.com/api/hotel-cancel.md): DEPRECATED, use /v1/hotel_cancel_preview and /v1/hotel_cancel_commit. Cancel a hotel booking and get a refund when eligible. Preview and commit in one call, POST /v1/hotel_cancel_preview plus /v1/hotel_cancel_commit is the two-step form, which shows the customer the refund before anything is cancell…
- [hotel-cancel-preview](https://docs.gojinko.com/api/hotel-cancel-preview.md): Preview what cancelling a hotel booking would cost
- [hotel-cancel-commit](https://docs.gojinko.com/api/hotel-cancel-commit.md): Cancel a hotel booking against a quote the customer accepted
- [hotel-cancel-status](https://docs.gojinko.com/api/hotel-cancel-status.md): Check how a hotel cancellation ended
- [hotel-ai-search](https://docs.gojinko.com/api/hotel-ai-search.md): Search hotels from one sentence, with follow-ups
- [hotel-ai-search-task](https://docs.gojinko.com/api/hotel-ai-search-task.md): Read a hotel AI search task
- [hotel-ai-search-events](https://docs.gojinko.com/api/hotel-ai-search-events.md): Stream a hotel AI search task's events
- [hotel-ai-search-cancel](https://docs.gojinko.com/api/hotel-ai-search-cancel.md): Cancel a hotel AI search task
- [car-search](https://docs.gojinko.com/api/car-search.md): Search live car rental offers
- [car-cancel-preview](https://docs.gojinko.com/api/car-cancel-preview.md): Preview the cost of cancelling a car rental booking
- [car-cancel-commit](https://docs.gojinko.com/api/car-cancel-commit.md): Cancel a car rental booking
- [car-cancel-status](https://docs.gojinko.com/api/car-cancel-status.md): Check the status of a car rental cancellation
- [trip](https://docs.gojinko.com/api/trip.md): Create and manage a trip: add or remove items and set travelers
- [select-ancillaries](https://docs.gojinko.com/api/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [trip ancillaries](https://docs.gojinko.com/api/trip/ancillaries.md): List purchasable ancillaries for a trip (no checkout)
- [checkout](https://docs.gojinko.com/api/checkout.md): Checkout a trip, returns a checkout URL the user opens to pay, plus the Shared Payment Token params an agent can use to pay programmatically
- [agent-payment submit](https://docs.gojinko.com/api/agent-payment/submit.md): Submit SPT payments; card submissions must use the payment hostname and are refused here
- [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
- [get-booking](https://docs.gojinko.com/api/get-booking.md): Retrieve booked item IDs and per-item servicing eligibility using the Jinko booking reference
- [best-price-guarantee](https://docs.gojinko.com/api/best-price-guarantee.md): Best Price Guarantee: ask for a hotel offer at a lower price found elsewhere
- [best-price-guarantee-status](https://docs.gojinko.com/api/best-price-guarantee-status.md): Best Price Guarantee: read the result of a request
- [webhooks register](https://docs.gojinko.com/api/webhooks/register.md): Register a webhook endpoint for booking lifecycle events
- [webhooks list](https://docs.gojinko.com/api/webhooks/list.md): List the caller's webhook subscriptions
- [webhooks get](https://docs.gojinko.com/api/webhooks/get.md): Get a webhook subscription and its recent deliveries
- [webhooks delete](https://docs.gojinko.com/api/webhooks/delete.md): Delete a webhook subscription
- [webhooks test](https://docs.gojinko.com/api/webhooks/test.md): Send a sample signed event to validate the endpoint
- [webhooks deliveries](https://docs.gojinko.com/api/webhooks/deliveries.md): List deliveries for a webhook subscription
- [webhooks replay](https://docs.gojinko.com/api/webhooks/replay.md): Replay a webhook delivery
- [flight-ai-search](https://docs.gojinko.com/api/flight-ai-search.md): Search flights from one sentence, with follow-ups
- [flight-ai-search-cancel](https://docs.gojinko.com/api/flight-ai-search-cancel.md): Cancel a flight AI search task
- [flight-ai-search-events](https://docs.gojinko.com/api/flight-ai-search-events.md): Stream a flight AI search task's events
- [flight-ai-search-task](https://docs.gojinko.com/api/flight-ai-search-task.md): Read a flight AI search task
- [flight-schedule](https://docs.gojinko.com/api/flight-schedule.md): Flights observed between two places on exact dates (no price)
- [trip payment-attempts](https://docs.gojinko.com/api/trip/payment-attempts.md): Read a payment attempt outcome

## OpenAPI Specs

- [public-api](/api-reference/public-api.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.