Shopping Cart (0)

Your cart is empty

Add some amazing travel packages to get started!

API Documentation

Build with CityGetaway API

Access our AI-powered travel platform with a simple, well-documented REST API. Create custom integrations and build amazing Montreal travel experiences.

Example Request
curl -X POST https://api.citygetaway.com/v1/itinerary \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "Montreal",
    "days": 5,
    "preferences": { "food": 9 }
  }'

Fast & Reliable

99.9% uptime with average response times under 200ms

Secure

Enterprise-grade security with OAuth 2.0 and API key authentication

Global CDN

Low latency worldwide with our distributed infrastructure

Well Documented

Comprehensive docs with code examples in multiple languages

Quick Start

Get up and running with the CityGetaway API in minutes

1

Get API Key

Sign up and generate your API key from the dashboard

2

Make Request

Include your API key in the Authorization header

3

Build

Start building amazing travel experiences

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API Endpoints

Explore our core API endpoints with example requests and responses

POST/api/v1/itinerary/generate

Generate an AI-powered Montreal itinerary based on preferences

Request Body

{
  "destination": "Montreal",
  "days": 5,
  "startDate": "2025-06-15",
  "budget": 2500,
  "travelers": 2,
  "preferences": {
    "culture": 8,
    "food": 9,
    "nature": 6,
    "nightlife": 5
  }
}

Response

{
  "success": true,
  "itinerary": {
    "id": "itin_abc123",
    "destination": "Montreal",
    "days": [...],
    "totalCost": 2450,
    "createdAt": "2025-01-15T10:30:00Z"
  }
}
GET/api/v1/attractions?city=montreal&limit=10

Retrieve a list of attractions in Montreal

Response

{
  "success": true,
  "attractions": [
    {
      "id": "attr_123",
      "name": "Notre-Dame Basilica",
      "category": "Historical",
      "rating": 4.7,
      "coordinates": {...}
    },
    ...
  ]
}
POST/api/v1/bookings

Book an activity or experience

Request Body

{
  "activityId": "act_456",
  "date": "2025-06-16",
  "travelers": 2,
  "timeSlot": "10:00"
}

Response

{
  "success": true,
  "booking": {
    "id": "book_789",
    "confirmationCode": "MTL-ABC123",
    "status": "confirmed",
    "totalPrice": 120.00
  }
}

Official SDKs

Use our official libraries to integrate faster in your preferred language

JavaScript/Node.js

v2.1.0
npm install @citygetaway/sdk
View Docs

Python

v1.5.2
pip install citygetaway
View Docs

Ruby

v1.3.1
gem install citygetaway
View Docs

Go

v1.2.0
go get github.com/citygetaway/sdk-go
View Docs

Rate Limits

Fair usage limits to ensure quality service for all users

PlanRequests/HourRequests/Day
Free1001,000
Pro1,00010,000
EnterpriseUnlimitedUnlimited

Ready to Start Building?

Get your API key and start integrating CityGetaway into your application today