{"openapi":"3.1.0","info":{"title":"IncentiveTrips API","version":"1.0.0","description":"Read-only access to the IncentiveTrips glass-box Index — ranked incentive-travel destinations and venues, with scores, hotel details, and licensed photography. The same data published on incentivetrips.com, as clean JSON. Attribution required when republished.","contact":{"name":"IncentiveTrips","url":"https://incentivetrips.com/developers"},"termsOfService":"https://incentivetrips.com/terms"},"servers":[{"url":"https://incentivetrips.com/api/v1","description":"Production"}],"security":[{},{"bearerAuth":[]}],"paths":{"/":{"get":{"summary":"API discovery document","operationId":"getRoot","responses":{"200":{"description":"OK"}}}},"/destinations":{"get":{"summary":"List destinations","operationId":"listDestinations","parameters":[{"name":"region","in":"query","schema":{"type":"string"},"description":"Europe | Americas | APAC | MEA"},{"name":"tier","in":"query","schema":{"type":"string","enum":["index","extended"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["rank","name"],"default":"rank"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100},"description":"Page size (max 100)."},{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"Rows to skip."}],"responses":{"200":{"description":"A page of destinations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Destination"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/destinations/{slug}":{"get":{"summary":"Get a destination","operationId":"getDestination","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"lisbon"}],"responses":{"200":{"description":"A destination","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Destination"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/venues":{"get":{"summary":"List venues","operationId":"listVenues","parameters":[{"name":"destination","in":"query","schema":{"type":"string"},"description":"Destination slug, e.g. lisbon"},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"},"description":"Hotel brand, e.g. Marriott"},{"name":"min_rooms","in":"query","schema":{"type":"integer"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["rank","rating"],"default":"rank"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100},"description":"Page size (max 100)."},{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"Rows to skip."}],"responses":{"200":{"description":"A page of venues","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Venue"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/venues/{slug}":{"get":{"summary":"Get a venue","operationId":"getVenue","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A venue","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Venue"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/indices":{"get":{"summary":"List composite indices","operationId":"listIndices","responses":{"200":{"description":"The live composite indices, ITDI first"}}}},"/indices/itdi":{"get":{"summary":"Get the Incentive Travel Demand Index","operationId":"getITDI","description":"The flagship live index of corporate incentive-travel demand: current reading, a ready-to-cite string, and the full history.","responses":{"200":{"description":"The ITDI","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DemandIndex"}}}}}}}}},"/keys":{"post":{"summary":"Issue an API key","operationId":"createKey","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"}}}}}},"responses":{"201":{"description":"Key issued (returned once)","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"key_id":{"type":"string"},"message":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Optional API key: `Authorization: Bearer itk_live_…`. Anonymous access allowed under fair use."}},"schemas":{"Destination":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"previous_rank":{"type":"integer","nullable":true},"trend":{"type":"string","nullable":true},"tier":{"type":"string","nullable":true,"enum":["index","extended",null]},"slug":{"type":"string"},"name":{"type":"string"},"country":{"type":"string","nullable":true},"country_code":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"coordinates":{"type":"object","properties":{"lat":{"type":"number","nullable":true},"lng":{"type":"number","nullable":true}}},"primary_airport":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"seasonality":{"type":"object","properties":{"best_months":{"type":"string","nullable":true},"high_season":{"type":"string","nullable":true},"low_season":{"type":"string","nullable":true}}},"group_fit":{"type":"string","nullable":true},"cost":{"type":"object","properties":{"avg_flight_usd":{"type":"integer","nullable":true},"avg_hotel_usd":{"type":"integer","nullable":true}}},"scores":{"type":"object","properties":{"overall":{"type":"number","nullable":true},"momentum":{"type":"number","nullable":true},"air_access":{"type":"number","nullable":true},"safety":{"type":"number","nullable":true},"value":{"type":"number","nullable":true},"infrastructure":{"type":"number","nullable":true},"planner_fit":{"type":"number","nullable":true}}},"reviews":{"type":"object","properties":{"average":{"type":"number","nullable":true},"count":{"type":"integer","nullable":true}}},"photo":{"type":"object","nullable":true,"properties":{"url":{"type":"string"},"credit":{"type":"string","nullable":true},"credit_url":{"type":"string","nullable":true}}},"updated_at":{"type":"string","nullable":true},"links":{"type":"object","additionalProperties":{"type":"string"}}}},"Venue":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"previous_rank":{"type":"integer","nullable":true},"trend":{"type":"string","nullable":true},"slug":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string","nullable":true},"destination":{"type":"object","nullable":true,"properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"location":{"type":"object","properties":{"city":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"coordinates":{"type":"object","properties":{"lat":{"type":"number","nullable":true},"lng":{"type":"number","nullable":true}}}}},"capacity":{"type":"object","properties":{"rooms":{"type":"integer","nullable":true},"max_group":{"type":"integer","nullable":true},"meeting_sqft":{"type":"integer","nullable":true},"full_buyout":{"type":"string","nullable":true}}},"summary":{"type":"string","nullable":true},"scores":{"type":"object","properties":{"overall":{"type":"number","nullable":true},"guest_experience":{"type":"number","nullable":true},"group_readiness":{"type":"number","nullable":true},"setting":{"type":"number","nullable":true},"dining_wellness":{"type":"number","nullable":true},"value":{"type":"number","nullable":true}}},"rating":{"type":"object","properties":{"google_rating":{"type":"number","nullable":true},"google_reviews":{"type":"integer","nullable":true}}},"nightly_rate_usd":{"type":"number","nullable":true},"managed":{"type":"boolean"},"contact":{"type":"object","properties":{"website":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}}},"photo":{"type":"object","nullable":true,"properties":{"url":{"type":"string"},"credit":{"type":"string","nullable":true},"credit_url":{"type":"string","nullable":true}}},"updated_at":{"type":"string","nullable":true},"links":{"type":"object","additionalProperties":{"type":"string"}}}},"DemandIndex":{"type":"object","properties":{"key":{"type":"string","example":"itdi"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"unit":{"type":"string","nullable":true},"source":{"type":"string","nullable":true},"reading":{"type":"object","properties":{"value":{"type":"number","nullable":true},"change_pct":{"type":"number","nullable":true},"direction":{"type":"string","nullable":true},"baseline":{"type":"integer"},"as_of":{"type":"string","nullable":true}}},"sparkline":{"type":"array","nullable":true,"items":{"type":"number"}},"history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","nullable":true},"value":{"type":"number","nullable":true}}}},"citation":{"type":"string","nullable":true},"links":{"type":"object","additionalProperties":{"type":"string"}}}},"Meta":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":"string","nullable":true}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}