Skip to main content
This is the single canonical reference for everything the Jinko Public API exposes. Each endpoint page shows:
  • Request / response schemas, parameters, field types, examples
  • A curl sample + try-it playground — fill in values and run a request
Prefer a typed client? The TypeScript SDK wraps these same endpoints with types and observability headers baked in.

​
Base URL

EnvironmentBase URL
Productionhttps://api.gojinko.com
Sandboxhttps://api.sandbox.gojinko.com
Production is the default. Use sandbox to test the full flow without touching prod data — it uses separate API keys (see Sandbox keys). All examples below use production.

​
Authentication

Authenticate every /v1 request with your API key: 
X-API-Key: jnk_your_key
Or as a bearer token: Authorization: Bearer jnk_your_key Get a key from the dashboard. See API keys for detail.

​
Observability

We strongly recommend setting these on every request, they make debugging possible when something goes wrong: 
X-Session-ID: <stable per session, any UUID or opaque string>
X-Request-ID: <fresh per request, any UUID>
Both land in the response headers too, so capture them on the client side. If you open a support ticket, include the X-Request-ID of the failing call.

​
Response envelope

Success: endpoint-specific JSON payload. Error: consistent envelope, same across all endpoints. 
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "departure_date must be in the future",
    "details": { "field": "departure_date" }
  }
}
See Errors & troubleshooting for the full status code reference.

​
Typical request

curl https://api.gojinko.com/v1/flight_search \
  -H "X-API-Key: jnk_..." \
  -H "X-Request-ID: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "JFK",
    "destination": "CDG",
    "trip_type": "roundtrip",
    "departure_date": "2026-06-15",
    "return_date": "2026-06-22"
  }'

​
Endpoint groups

Flights, discovery

Cache-backed search by route or destination (flight_calendar, find_dates, lowest_fare, find_destination, price_monitoring). Fast; stale-within-minutes prices.

Flights, live pricing

Live search + price-check via flight_search. Returns bookable trip_item_token.

Hotels

Live hotel search. htl_* tokens plug into the same trip as flights.

Trip

Create a trip, add/remove items, upsert travelers, select ancillaries, then book.

Bookings

Guest lookup by booking_ref + last_name.

Refund

Check eligibility → commit → poll status.

Exchange

Shop → price → commit → status (4-step flow).