# 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.dev.gojinko.com/api-reference/introduction.md): What the Jinko API offers and how to call it: explore travel demand, search flights and hotels, build a trip, pay, and manage bookings over HTTP.
- [agent-payment submit](https://docs.dev.gojinko.com/api/agent-payment/submit.md): Submit an agent payment — present trip_id + a Shared Payment Token to schedule + authorize the booking; returns a checkout_url fallback if customer action (3DS) is required
- [audience](https://docs.dev.gojinko.com/api/audience.md): Rank traveler audiences for a destination
- [audience trend](https://docs.dev.gojinko.com/api/audience/trend.md): Demand time series per traveler type segment
- [checkout](https://docs.dev.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
- [destination](https://docs.dev.gojinko.com/api/destination.md): Most demanded destinations (city or country) from a given origin, as a % share of total demand
- [destination trend](https://docs.dev.gojinko.com/api/destination/trend.md): Destination demand as a time series. Observe how demand for the top destinations varies by day, week, or month
- [exchange commit](https://docs.dev.gojinko.com/api/exchange/commit.md): Commit a flight exchange
- [exchange price](https://docs.dev.gojinko.com/api/exchange/price.md): Price a specific exchange offer
- [exchange shop](https://docs.dev.gojinko.com/api/exchange/shop.md): Shop for flight exchange alternatives
- [exchange status](https://docs.dev.gojinko.com/api/exchange/status.md): Check the status of an exchange
- [find-dates](https://docs.dev.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.dev.gojinko.com/api/find-destination.md): Discover travel destinations accessible from your departure airports
- [flight-calendar](https://docs.dev.gojinko.com/api/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [flight-search](https://docs.dev.gojinko.com/api/flight-search.md): Get live flight pricing — search by route, or re-price a known offer
- [get-booking](https://docs.dev.gojinko.com/api/get-booking.md): Retrieve a booking using the Jinko booking reference and the traveler's last name
- [hotel-cancel](https://docs.dev.gojinko.com/api/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [hotel-details](https://docs.dev.gojinko.com/api/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [hotel-search](https://docs.dev.gojinko.com/api/hotel-search.md): Search live hotel inventory and rates
- [lowest-fare](https://docs.dev.gojinko.com/api/lowest-fare.md): Cheapest fares for a fixed route + date — up to ten itineraries, cheapest first
- [market](https://docs.dev.gojinko.com/api/market.md): For a given destination (city or country), where the demand comes from (city or country), as a % share of total demand
- [market trend](https://docs.dev.gojinko.com/api/market/trend.md): Market demand as a time series. Observe how demand from the top source markets varies by day, week, or month
- [price-monitoring](https://docs.dev.gojinko.com/api/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [refund check](https://docs.dev.gojinko.com/api/refund/check.md): Check refund eligibility and estimated amount
- [refund commit](https://docs.dev.gojinko.com/api/refund/commit.md): Initiate a refund for a booked flight
- [refund status](https://docs.dev.gojinko.com/api/refund/status.md): Check the status of a refund
- [select-ancillaries](https://docs.dev.gojinko.com/api/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [trend](https://docs.dev.gojinko.com/api/trend.md): The most flexible tool. Supply explicit origin and destination (each can be a list) to see how demand evolved for a specific route or question
- [trip](https://docs.dev.gojinko.com/api/trip.md): Create and manage a trip — add or remove items, set travelers, select ancillaries
- [trip-status](https://docs.dev.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.dev.gojinko.com/api/trip/ancillaries.md): List purchasable ancillaries for a trip (no checkout)
- [webhooks](https://docs.dev.gojinko.com/api/webhooks.md): Delete a webhook subscription
- [delete-webhook](https://docs.dev.gojinko.com/api/webhooks/delete.md): Delete a webhook subscription
- [get-webhook](https://docs.dev.gojinko.com/api/webhooks/get.md): Fetch a webhook subscription and its recent deliveries
- [list-webhooks](https://docs.dev.gojinko.com/api/webhooks/list.md): List your registered webhook subscriptions
- [register-webhook](https://docs.dev.gojinko.com/api/webhooks/register.md): Register a callback URL to receive signed booking lifecycle events
- [webhooks test](https://docs.dev.gojinko.com/api/webhooks/test.md): Send a sample signed event to validate the endpoint
- [API keys](https://docs.dev.gojinko.com/authentication/api-keys.md): Get and use API keys (jnk_*) for programmatic access to Jinko.
- [OAuth](https://docs.dev.gojinko.com/authentication/oauth.md): Browser-based auth for MCP clients (DCR) and the CLI (device flow).
- [jinko agent-pay submit](https://docs.dev.gojinko.com/cli/agent-pay/submit.md): Submit a Shared Payment Token to schedule + authorize the booking
- [jinko auth login](https://docs.dev.gojinko.com/cli/auth/login.md): Authenticate with Jinko (OAuth or API key).
- [jinko auth logout](https://docs.dev.gojinko.com/cli/auth/logout.md): Clear stored credentials.
- [jinko auth status](https://docs.dev.gojinko.com/cli/auth/status.md): Show current authentication status.
- [jinko checkout](https://docs.dev.gojinko.com/cli/checkout.md): Checkout a trip — returns a checkout URL the user opens to pay, plus agent payment params
- [jinko config set](https://docs.dev.gojinko.com/cli/config/set.md): Set a config value. Keys: api_key, environment
- [jinko config show](https://docs.dev.gojinko.com/cli/config/show.md): Show current configuration.
- [jinko exchange commit](https://docs.dev.gojinko.com/cli/exchange/commit.md): Commit a flight exchange
- [jinko exchange price](https://docs.dev.gojinko.com/cli/exchange/price.md): Price a specific exchange offer
- [jinko exchange shop](https://docs.dev.gojinko.com/cli/exchange/shop.md): Shop for flight exchange alternatives
- [jinko exchange status](https://docs.dev.gojinko.com/cli/exchange/status.md): Check the status of an exchange
- [jinko find-dates](https://docs.dev.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.dev.gojinko.com/cli/find-destination.md): Discover travel destinations accessible from your departure airports
- [jinko flight-calendar](https://docs.dev.gojinko.com/cli/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [jinko flight-search](https://docs.dev.gojinko.com/cli/flight-search.md): Get live flight pricing — search by route, or re-price a known offer
- [jinko get-ancillaries](https://docs.dev.gojinko.com/cli/get-ancillaries.md): List purchasable ancillaries for a trip (bags, seats, meals) — no checkout URL
- [jinko get-booking](https://docs.dev.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.dev.gojinko.com/cli/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [jinko hotel-details](https://docs.dev.gojinko.com/cli/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [jinko hotel-search](https://docs.dev.gojinko.com/cli/hotel-search.md): Search live hotel inventory and rates
- [jinko lowest-fare](https://docs.dev.gojinko.com/cli/lowest-fare.md): Cheapest fares for a fixed route + date — up to ten itineraries, cheapest first
- [Overview](https://docs.dev.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 and hotels, build a trip, pay, and manage bookings.
- [jinko price-monitoring](https://docs.dev.gojinko.com/cli/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [jinko refund check](https://docs.dev.gojinko.com/cli/refund/check.md): Check refund eligibility and estimated amount
- [jinko refund commit](https://docs.dev.gojinko.com/cli/refund/commit.md): Initiate a refund for a booked flight
- [jinko refund status](https://docs.dev.gojinko.com/cli/refund/status.md): Check the status of a refund
- [jinko schema](https://docs.dev.gojinko.com/cli/schema.md): Show request/response schema for a command. List all if no command given.
- [jinko select-ancillaries](https://docs.dev.gojinko.com/cli/select-ancillaries.md): Select ancillaries (baggage, seats, meals) for a trip item
- [jinko travel-demand audience](https://docs.dev.gojinko.com/cli/travel-demand/audience.md): Traveler type mix for a destination
- [jinko travel-demand audience-trend](https://docs.dev.gojinko.com/cli/travel-demand/audience-trend.md): Demand time series for the traveler type mix
- [jinko travel-demand destination](https://docs.dev.gojinko.com/cli/travel-demand/destination.md): Most demanded destinations (city or country) from a given origin, as a % share of total demand
- [jinko travel-demand destination-trend](https://docs.dev.gojinko.com/cli/travel-demand/destination-trend.md): Destination demand as a time series. Observe how demand for the top destinations varies by day, week, or month
- [jinko travel-demand market](https://docs.dev.gojinko.com/cli/travel-demand/market.md): For a given destination (city or country), where the demand comes from (city or country), as a % share of total demand
- [jinko travel-demand market-trend](https://docs.dev.gojinko.com/cli/travel-demand/market-trend.md): Market demand as a time series. Observe how demand from the top source markets varies by day, week, or month
- [jinko travel-demand trend](https://docs.dev.gojinko.com/cli/travel-demand/trend.md): The most flexible tool. Supply explicit origin and destination (each can be a list) to see how demand evolved for a specific route or question
- [jinko trip](https://docs.dev.gojinko.com/cli/trip.md): Create and manage a trip — add or remove items, set travelers, select ancillaries
- [jinko trip-status](https://docs.dev.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.dev.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.dev.gojinko.com/concepts/errors.md): HTTP status codes, error envelope, and what to do when things go sideways.
- [LLMs.txt](https://docs.dev.gojinko.com/concepts/llms-txt.md): Machine-readable documentation entry points for AI agents.
- [Concepts](https://docs.dev.gojinko.com/concepts/overview.md): Trip, quote, fulfillment, the mental model for Jinko's booking flow.
- [Rate Limits](https://docs.dev.gojinko.com/concepts/rate-limits.md): Current Jinko platform rate limits.
- [CLI](https://docs.dev.gojinko.com/connect/cli.md): Install the Jinko CLI and run the booking flow from your shell.
- [MCP](https://docs.dev.gojinko.com/connect/mcp.md): Connect OAuth-capable MCP clients to Jinko over the remote endpoint.
- [TypeScript SDK](https://docs.dev.gojinko.com/connect/sdk.md): @gojinko/api-client, typed wrapper around the Jinko REST API.
- [Skills](https://docs.dev.gojinko.com/connect/skills.md): Prebuilt prompts + workflows that make coding agents better at using Jinko.
- [Flight booking](https://docs.dev.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.dev.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.dev.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.dev.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.dev.gojinko.com/introduction.md): Build agents that discover, price, book, and manage travel products.
- [How to Connect](https://docs.dev.gojinko.com/quickstart.md): Connect your AI agent to Jinko in under 2 minutes.
- [Checkout Trip](https://docs.dev.gojinko.com/tools/checkout.md): Checkout a trip: returns a checkout URL the user opens to pay, plus agent payment params
- [Find Dates](https://docs.dev.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.dev.gojinko.com/tools/find-destination.md): Discover travel destinations accessible from your departure airports
- [Flight Calendar](https://docs.dev.gojinko.com/tools/flight-calendar.md): Search flights between a known origin and destination for flexible dates
- [Flight Exchange](https://docs.dev.gojinko.com/tools/flight-exchange.md): Exchange a booked flight for a different itinerary
- [Flight Refund](https://docs.dev.gojinko.com/tools/flight-refund.md): Check refund eligibility, commit a refund, or check refund status for a booked flight
- [Flight Search](https://docs.dev.gojinko.com/tools/flight-search.md): Get live flight pricing: search by route, or re-price a known offer
- [Get Booking](https://docs.dev.gojinko.com/tools/get-booking.md): Retrieve a booking using the Jinko booking reference and the traveler's last name
- [Get Trip](https://docs.dev.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.dev.gojinko.com/tools/hotel-cancel.md): Cancel a hotel booking and get a refund when eligible
- [Hotel Details](https://docs.dev.gojinko.com/tools/hotel-details.md): Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel
- [Hotel Search](https://docs.dev.gojinko.com/tools/hotel-search.md): Search live hotel inventory and rates
- [Lowest Fare](https://docs.dev.gojinko.com/tools/lowest-fare.md): Cheapest fares for a fixed route + date: up to ten itineraries, cheapest first
- [Overview](https://docs.dev.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 and hotels, build a trip, pay, and manage bookings from inside a conversation.
- [Price Monitoring](https://docs.dev.gojinko.com/tools/price-monitoring.md): Monitor price for a specific origin, destination, and dates pair
- [Submit Agent Payment](https://docs.dev.gojinko.com/tools/submit-agent-payment.md): Redeem a Shared Payment Token to authorize the booking server-side
- [Trip](https://docs.dev.gojinko.com/tools/trip.md): Create and manage a trip: add or remove items, set travelers, select ancillaries

## OpenAPI Specs

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