Skip to main content
queue times

  

Overview

The SITA Wait Time API is a REST based service which provides information about the length of time that a passenger may expect to wait in a particular area, such as in airport security line, or customs queue. The Wait Time service collect data from a number of different data providers and normalises the data to standard format. This means consumers get request data from multiple airports in a single, easy to consume format

Example of information include: airportCode: "MIA", queueId: "c379xxx7252xx57 9314fb03xxx8bf2", queueName: "1 General", projectedWaitTime : 60, projectedMinWaitMinutes: 1, projectedMaxWaitMinutes: 3,localTime: "2020-04-28T21:32:01-04:00",time: "2020-04-29T01:32:01Z", status: "Closed" 

This API can answer the following questions:

  • average length of time that a passenger may expect to wait in a particular area airport
  • security line locations and names

Please use our Contact Us form if you would like to publish your data with the SITA Wait Time API

 

Technical Documentation

 

SITA Advanced Data Services

version 2.3.0-SNAPSHOT

1 Revision History

DateVersionDescription

08 October 2018

1.0

Initial Spring Rest Docs Version

26 July 2023

1.1

Added rate limit and OAuth

2 Introduction

The SITA Wait Time API is a REST based service which provides wait time information for airports around the world.

2.1 Registration and API Signup

To access the APIs you will need an API key. These can be obtained by creating an account on https://www.developer.aero/ and registering your interest for access to the API.

2.2 Authentication

To access the APIs an OAuth access token must be supplied. To obtain an OAuth token a request must be sent to the https://sitaopen.api.aero/otp/oauth/token endpoint using the OAuth2 Client Credential flow, using your API key as the client_id, and your consumer secret as the client_secret.

Once an access token has been obtained, it can be placed in the Authorization HTTP header as a bearer token, for example:

Authorization: Bearer eyJ92dNw9dka...

2.3 Security

  • All incoming requests will be REST over HTTPS.
  • Users are authenticated using their OAuth token.
  • Certain response payload elements will be filtered based on permissions associated with their token.

2.4 Rate Limiting

All incoming requests are subject to a rate limiting restriction. The following headers are included in HTTP responses:

HeaderDescription

X-RateLimit-Limit

The total number of requests allowed in the current time window

X-RateLimit-Remaining

The number of requests left for the current time window

X-RateLimit-Policy

The policy describing how many request per time window are allowed

X-RateLimit-Reset

The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded

retry-after

The EPOCH timestamp at which the current rate limit window resets. Header only displayed after rate limit has been exceeded

3 SITA Waittime API Service

This section describes each Data API service. Detailed API structure, example requests and responses, JSON schema for request (where appropriate) and responses, and error response codes and formats are included.

3.1 Standard Error Response

All resources end points shown below may generate errors during its request processing. Below is a sample error response.

Response fields

PathTypeDescription

errors

Object

Object that hold error information

errors.error[]

Array

List of errors

errors.error[].code

Number

Data API Internal Error Code

errors.error[].description

String

Error Description

errors.error[].parameterName

String

Attribute

Curl request

$ curl 'https://sitaopen.api.aero/waittime:12345/v1/current/GRU' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...'

HTTP response

HTTP/1.1 403 Forbidden
Content-Type: application/json
Content-Length: 158

{
  "errors" : {
    "error" : [ {
      "description" : "Error Description",
      "code" : 400,
      "parameterName" : "invalidValue"
    } ]
  }
}

3.2 Wait Time

3.2.1 Get Current Wait Time V1

Request headers
NameDescription

Content-Type

The Content-Type of this request.

Authorization

Authorization header that contains the access token.

Path parameters
Table 1. /v1/current/{airportCode}
ParameterDescription

airportCode

Valid Airport Code (IATA or ICAO)

Response fields
PathTypeDescription

current[]

Array

List of Current Wait Time objects

current[].airportCode

String

Valid Airport Code

current[].airportName

String

Airport Name

current[].confidence

Number

Confidence on the information, if available

current[].localTime

String

Local Time in the Airport

current[].projectedMaxWaitMinutes

Number

Projected Maximum Wait Time (minutes)

current[].projectedMinWaitMinutes

Number

Projected Minimum Wait Time (minutes)

current[].projectedWaitTime

Number

Projected Wait Time (minutes)

current[].queueId

String

Queue Identification

current[].queueName

String

Queue Name

current[].time

String

UTC time in the Airport

Curl request
$ curl 'https://sitaopen.api.aero/waittime:12345/v1/current/GRU' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 336

{
  "current" : [ {
    "airportCode" : "GRU",
    "airportName" : "Guarulhos Airport",
    "queueId" : "1256",
    "queueName" : "Queue Name",
    "projectedWaitTime" : 13,
    "projectedMinWaitMinutes" : 7,
    "projectedMaxWaitMinutes" : 20,
    "confidence" : 80,
    "localTime" : "17:30",
    "time" : "15:30"
  } ]
}

3.2.2 Get Current Wait Time V2

Request headers
NameDescription

Content-Type

The Content-Type of this request.

Authorization

Authorization header that contains the access token.

Path parameters
Table 1. /v2/current/{airportCode}
ParameterDescription

airportCode

Valid Airport Code (IATA or ICAO)

Response fields
PathTypeDescription

current[]

Array

List of Current Wait Time objects

current[].airportCode

String

Valid Airport Code

current[].airportName

String

Airport Name

current[].confidence

Number

Confidence on the information, if available

current[].localTime

String

Local Time in the Airport

current[].projectedMaxWaitMinutes

Number

Projected Maximum Wait Time (minutes)

current[].projectedMinWaitMinutes

Number

Projected Minimum Wait Time (minutes)

current[].projectedWaitTime

Number

Projected Wait Time (minutes)

current[].queueId

String

Queue Identification

current[].queueName

String

Queue Name

current[].status

String

Status of the Queue ('Open', 'Closed')

current[].time

String

UTC time in the Airport

Curl request
$ curl 'https://sitaopen.api.aero/waittime:12345/v2/current/GRU' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJkb2N1bWVudGF0aW9uIiwidG9rZW4ifQ...'
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 360

{
  "current" : [ {
    "airportCode" : "GRU",
    "airportName" : "Guarulhos Airport",
    "queueId" : "1256",
    "queueName" : "Queue Name",
    "projectedWaitTime" : 13,
    "projectedMinWaitMinutes" : 7,
    "projectedMaxWaitMinutes" : 20,
    "confidence" : 80,
    "localTime" : "17:30",
    "time" : "15:30",
    "status" : "Open"
  } ]
}
 

 

Contact Us

 

For subscription and sales queries, please contact:

Product Inquiries
WaitTime API

Contact Us

 

For any technical queries and support, please contact:

Technical Support Team

Contact Us

contact-icon

Do you have a question? We are here, ready to help

Get in touch

About us

We are the world's leading specialist in air transport communications and IT solutions. 

 

bottom navigation SITA logo