# 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): The flight add-ons, car rental extras, and hotel options supported by 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): Choose between a checkout link, a Shared Payment Token, or a virtual credit card.
- [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 booking and rebook it when an eligible lower price appears.
- [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.
- [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
- [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
- [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 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, up to ten cheapest itineraries, one per date-pair, spread across the month
- [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
- [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): Check refund eligibility only; use flight_refund_preview for customer-facing amounts
- [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
- [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): 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 cancelled. `refund_amount` is what the CUSTOMER gets back; all amounts are cu…
- [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
- [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
- [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 a typed SPT payment with Idempotency-Key, or a legacy flat Shared Payment Token
- [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)
- [get-booking](https://docs.gojinko.com/api/get-booking.md): Retrieve booked item IDs and per-item servicing eligibility using the Jinko booking reference
- [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-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.