Getting started

Welcome to Geneva Airport's Open APIs. This guide will help you get started with consuming our Open APIs, which provide public data such as flight schedules and more. The process is simple, and you will be ready to start making API calls in no time.

Step 1: Request a subscription key

To access the APIs, you’ll need a subscription key. Here's how you can request one through the Developer Portal:

1. Request access:

   • Navigate to the Products section of the Developer Portal.

   • Select the one of the open product.

   • Click on the Subscribe button, review and accept the terms and conditions.

Your request will be reviewed by our team. You’ll receive an email once your subscription is approved

Step 2: Await subscription approval

Once you have submitted your request, your subscription will go through an approval process. You will receive an email once your subscription is approved.

Step 3: Retrieve your subscription key

After your subscription is approved, follow these steps to access your subscription key:

1. Access Your Key:

   • Go to the Profile section or the Subscriptions tab.

   • Locate your active subscription under the products section.

   • Copy your subscription key for use in API requests.

Step 4: Make API Requests

Now that you have your subscription key, you can start making API requests. All requests to the APIs must include your subscription key in the Ocp-Apim-Subscription-Key header.

Example request using curl:

curl -X GET "https://api.gva.ch/ao/open/api/v1/Flights/Arrivals?dayOffset=0" -H "Ocp-Apim-Subscription-Key: {your-subscription-key}"

Alternatively, you can start making API requests by including your subscription key in the URL by passing the query parameter subscription-key.

Example request using curlorweb browser:

curl -X GET "https://api.gva.ch/ao/open/api/v1/Flights/Arrivals?dayOffset=0&subscription-key={your-subscription-key}"

Step 5: Explore API documentation

In the Developer Portal, you’ll find detailed documentation for each available API endpoint:

• Go to the API Documentation section.

• Use the API Explorer to test the endpoints with your subscription key.

You can also download the Open API or WADL file to explore the API definitions locally.