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
1 Revision History
| Date | Version | Description |
|---|---|---|
|
|
|
|
|
|
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:
| Header | Description |
|---|---|
| The total number of requests allowed in the current time window |
| The number of requests left for the current time window |
| The policy describing how many request per time window are allowed |
| The number of seconds remaining in the current time window. Header not displayed after rate limit has been exceeded |
| 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 |
|---|---|---|
|
| Object that hold error information |
|
| List of errors |
|
| Data API Internal Error Code |
|
| Error Description |
|
| 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 |
|---|---|
| The Content-Type of this request. |
| Authorization header that contains the access token. |
Path parameters
| Parameter | Description |
|---|---|
| Valid Airport Code (IATA or ICAO) |
Response fields
| Path | Type | Description |
|---|---|---|
|
| List of Current Wait Time objects |
|
| Valid Airport Code |
|
| Airport Name |
|
| Confidence on the information, if available |
|
| Local Time in the Airport |
|
| Projected Maximum Wait Time (minutes) |
|
| Projected Minimum Wait Time (minutes) |
|
| Projected Wait Time (minutes) |
|
| Queue Identification |
|
| Queue Name |
|
| 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
| Name | Description |
|---|---|
| The Content-Type of this request. |
| Authorization header that contains the access token. |
Path parameters
| Parameter | Description |
|---|---|
| Valid Airport Code (IATA or ICAO) |
Response fields
| Path | Type | Description |
|---|---|---|
|
| List of Current Wait Time objects |
|
| Valid Airport Code |
|
| Airport Name |
|
| Confidence on the information, if available |
|
| Local Time in the Airport |
|
| Projected Maximum Wait Time (minutes) |
|
| Projected Minimum Wait Time (minutes) |
|
| Projected Wait Time (minutes) |
|
| Queue Identification |
|
| Queue Name |
|
| Status of the Queue ('Open', 'Closed') |
|
| 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
