Waittime Overview

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
dots.support@sita.aero

version 2.3.0-SNAPSHOT

1 Revision History

Date	Version	Description
`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 in an Authorization header in the request. To obtain an OAuth token a request must be sent to the https://sitaopen.api.aero/waittime/oauth/token endpoint using the OAuth2 Client Credential flow.Use your API key as the client_id, and your consumer secret as the client_secret these should be base64 encoded in an Authorization header when sent to the OAuth endpoint.

Please note the OAuth tokens have an expiry of one hour after the token has been retrieved, after the token has expired you will need to re-issue a request to get a new token.

curl --location 'https://sitaopen.api.aero/waittime/oauth/token' \--header 'Authorization: Basic YWJjZGVmZ2hpamtsbW5vcC5xcnN0dXY='

You should then see your OAuth token in the response.

"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOJIUzI1NiJ9.eyJyZWZyZXNoX3Rva2VuX2V4cGlyZXNfaW4iOiIzNTk5Iiwic3ViIjoic2l0YSIsImFwaV9cm9kdWN0X2xpc3QiOiJbRE9UUy1GbGlnaHQtQ29ubmVjdGlvbi1JbnRlcm5hbF0iLCJpc3MiOiJ1cm46XC9cL2FwaWdlZS1lZdlLUpXVC1wb2xpY3ktdGVzdCIsImFwaV9hY2Nlc3NfdG9rZW4iOiIweXlIZHduSUdtOGo5WlN6WWtuYTBsWG9ZNTFvIiwiYXBpX3JlZnJlc2hfdG9rZW4iOiJraHNlaXN2T3JwSHBUd2NuUVRHdXdBdVdicXNpamNQTyIsImFwaV9zY29wZSI6IiIsImF1ZCI6ImFwaWdlZS1hcGkiLCJleHAiOj3MzAyOTI3MzIsImFwcF9pZCI6IjIxYzI5NTgyLTIwZTktNDkwMS1hNjExLTVkM2UwM2QxNzFkYiIsImV4cGlyZXNfaW4iOiIzNTk5IiwiaWF0IjoxNzMwMjg5MTMyLCJqdGkiOiI3ZmEzNTU4Mi0xNDhmLTRiMmEtODYxMS0wNWI4NDg5YjFjYmMifQ.g_dFH-08DGADOX9HIk7wzX5edxXejVsnCen27A25TQ0"

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

curl --location 'https://sitaopen.api.aero/waittime/v2/current/PHX' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOJIUzI1NiJ9.eyJyZWZyZXNoX3Rva2VuX2V4cGlyZXNfaW4iOiIzNTk5Iiwic3ViIjoic2l0YSIsImFwaV9cm9kdWN0X2xpc3QiOiJbRE9UUy1GbGlnaHQtQ29ubmVjdGlvbi1JbnRlcm5hbF0iLCJpc3MiOiJ1cm46XC9cL2FwaWdlZS1lZdlLUpXVC1wb2xpY3ktdGVzdCIsImFwaV9hY2Nlc3NfdG9rZW4iOiIweXlIZHduSUdtOGo5WlN6WWtuYTBsWG9ZNTFvIiwiYXBpX3JlZnJlc2hfdG9rZW4iOiJraHNlaXN2T3JwSHBUd2NuUVRHdXdBdVdicXNpamNQTyIsImFwaV9zY29wZSI6IiIsImF1ZCI6ImFwaWdlZS1hcGkiLCJleHAiOj3MzAyOTI3MzIsImFwcF9pZCI6IjIxYzI5NTgyLTIwZTktNDkwMS1hNjExLTVkM2UwM2QxNzFkYiIsImV4cGlyZXNfaW4iOiIzNTk5IiwiaWF0IjoxNzMwMjg5MTMyLCJqdGkiOiI3ZmEzNTU4Mi0xNDhmLTRiMmEtODYxMS0wNWI4NDg5YjFjYmMifQ.g_dFH-08DGADOX9HIk7wzX5edxXejVsnCen27A25TQ0'

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:

Header	Description
`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

Path	Type	Description
`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

Name	Description
`Content-Type`	The Content-Type of this request.
`Authorization`	Authorization header that contains the access token.

Path parameters

Table 1. /v1/current/{airportCode}
Parameter	Description
`airportCode`	Valid Airport Code (IATA or ICAO)

Response fields

Path	Type	Description
`current[]`	`Array`	List of Current Wait Time objects
`current[].airportCode`	`String`	Valid Airport Code
`current[].airportName`	`String`	Airport Name
`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: 312

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

3.2.2 Get Current Wait Time V2

Request headers

Name	Description
`Content-Type`	The Content-Type of this request.
`Authorization`	Authorization header that contains the access token.

Path parameters

Table 1. /v2/current/{airportCode}
Parameter	Description
`airportCode`	Valid Airport Code (IATA or ICAO)

Response fields

Path	Type	Description
`current[]`	`Array`	List of Current Wait Time objects
`current[].airportCode`	`String`	Valid Airport Code
`current[].airportName`	`String`	Airport Name
`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', 'Unknown')
`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: 336

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

SITA Wait Time API2.4.0

Overview

Technical Documentation

1 Revision History

2 Introduction

2.1 Registration and API Signup

2.2 Authentication

2.3 Security

2.4 Rate Limiting

3 SITA Waittime API Service

3.1 Standard Error Response

Response fields

Curl request

HTTP response

3.2 Wait Time

3.2.1 Get Current Wait Time V1

Request headers

Path parameters

Response fields

Curl request

HTTP response

3.2.2 Get Current Wait Time V2

Request headers

Path parameters

Response fields

Curl request

HTTP response

Contact Us

\ For subscription and sales queries, please contact:

For any technical queries and support, please contact:

About us