Query flight legs based on given search criteria.
GET {{baseUrl}}/flightlegs?carrier=<string>&flight-number=<string>&operational-suffix=<string>&origin-date=<string>&origin-iata-code=<string>&destination-iata-code=<string>&from=<string>&to=<string>&max-results=<integer>
If no query parameter is set the search will be reduced to the last 24 hours. If no maxResult is set a maximum of 1000 records will be returned.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
carrier | string | IATA 2-digit code of the operating carrier. | |
flight-number | string | The numeric flight number of operating airline. | |
operational-suffix | string | Used to distinguish two flights having the same flight number and departing from their respective origin stations on the same date. | |
origin-date | string | The day of operation, i.e. local day of schedule off-block time in UTC at first departure airport of flight. | |
origin-iata-code | string | The IATA code of an airport as origin airport of a flight leg. | |
destination-iata-code | string | The IATA code of an airport as destination airport of a flight leg. | |
from | string | The (included) start point of the interval in UTC for the scheduled departure/ arrival time depending on values for origin/ destination airport. e.g. 2020-01-31T12:30:00.000Z. If used the from and the to parameter has to be set. | |
to | string | The (excluded) end point of the interval in UTC for the scheduled departure/ arrival time depending on values for origin/ destination airport. e.g. 2020-01-31T12:30:00.000Z. If used the from and the to parameter has to be set. | |
max-results | string | The maximum number of results. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
[{"id":"ut cillum","identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"enim magna fugiat","origin-date":"1956-05-11","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":false,"state":"OFF_BLOCK","meta":{"created-at":"1980-11-29T05:49:09.587Z","created-by":{"user-id":"irure voluptate esse","user-name":"Lor"},"created-event-type":"e","created-event-time":"2007-07-02T15:47:04.609Z","modified-count":2392463,"modified-at":"2002-06-22T00:24:55.817Z","modified-by":{"user-id":"pariatur in consequat esse","user-name":"mollit minim"},"modified-event-type":"labore sed dolor","modified-event-time":"1945-06-21T02:27:28.881Z"},"secondary-identifiers":[{"created":"2011-08-30T19:38:09.703Z","identifier":"deserunt culpa occaecat","source":"laborum ex commodo Ut"},{"created":"1973-09-06T03:54:19.712Z","identifier":"ea","source":"laboris sit consequat anim culpa"}],"codeshares":[{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"ea commodo","origin-date":"2001-01-21","origin-iata-code":"AAA","operational-suffix":"B"},{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"anim irure aute","origin-date":"1981-08-13","origin-iata-code":"AAA","operational-suffix":"B"}],"flight-segments":[{"identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"eu non enim amet","origin-date":"2007-01-22","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":true,"secondary-identifiers":[{"created":"1972-04-26T21:49:03.570Z","identifier":"nulla eu sit ipsum","source":"sit Lorem dolore nisi"},{"created":"1963-08-28T01:28:59.221Z","identifier":"in sit esse","source":"Lo"}]},{"identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"proident qui","origin-date":"2016-12-29","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":true,"secondary-identifiers":[{"created":"2013-04-29T14:29:14.927Z","identifier":"do aute ad dolor","source":"et irure"},{"created":"1988-07-27T16:37:16.874Z","identifier":"sint consectetur elit cu","source":"proident labore sunt in id"}]}],"outbound-resources":{"aircraft-parking-position":{"location":"Apron","timestamp":"2012-09-01T02:42:48.157Z"},"passenger-gates":[{"location":"Apron","timestamp":"1945-10-24T08:05:49.953Z"},{"location":"Apron","timestamp":"1966-01-10T14:35:46.218Z"}],"remote-operational-gates":[{"location":"Apron","timestamp":"1986-07-13T18:58:09.495Z"},{"location":"Apron","timestamp":"1962-09-10T05:29:13.231Z"}],"runway":{"location":"Apron","timestamp":"1971-09-04T04:05:40.913Z"},"aircraft-terminal":{"location":"Apron","timestamp":"1972-04-28T10:25:47.103Z"},"public-terminals":[{"location":"Apron","timestamp":"2022-04-03T04:20:13.755Z"},{"location":"Apron","timestamp":"1981-12-29T07:49:16.105Z"}],"baggage-claim-units":[{"location":"Apron","timestamp":"1963-07-29T04:41:09.917Z"},{"location":"Apron","timestamp":"2009-02-23T06:38:40.605Z"}],"baggage-make-up-belts":[{"location":"Apron","timestamp":"1991-04-05T17:56:46.708Z"},{"location":"Apron","timestamp":"2001-12-12T09:51:43.333Z"}],"baggage-transfer-laterals":[{"location":"Apron","timestamp":"1963-06-30T02:06:40.007Z"},{"location":"Apron","timestamp":"1969-06-06T08:20:54.413Z"}],"check-in-desks":{"location":"Apron","timestamp":"1971-04-06T23:42:01.145Z"}},"inbound-resources":{"aircraft-parking-position":{"location":"Apron","timestamp":"1945-01-31T05:49:27.386Z"},"passenger-gates":[{"location":"Apron","timestamp":"2008-08-11T01:19:36.164Z"},{"location":"Apron","timestamp":"1966-10-14T15:58:08.283Z"}],"remote-operational-gates":[{"location":"Apron","timestamp":"2010-05-03T02:27:39.900Z"},{"location":"Apron","timestamp":"1983-04-05T07:38:15.800Z"}],"runway":{"location":"Apron","timestamp":"1960-04-10T08:25:17.687Z"},"aircraft-terminal":{"location":"Apron","timestamp":"1949-04-08T12:16:49.212Z"},"public-terminals":[{"location":"Apron","timestamp":"1947-06-10T18:03:23.308Z"},{"location":"Apron","timestamp":"1996-10-26T08:48:10.160Z"}],"baggage-claim-units":[{"location":"Apron","timestamp":"2003-05-13T04:29:50.820Z"},{"location":"Apron","timestamp":"1959-02-21T14:37:43.841Z"}],"baggage-make-up-belts":[{"location":"Apron","timestamp":"1955-03-11T01:18:55.177Z"},{"location":"Apron","timestamp":"1973-04-29T02:47:44.924Z"}],"baggage-transfer-laterals":[{"location":"Apron","timestamp":"1966-11-20T17:50:28.074Z"},{"location":"Apron","timestamp":"2000-04-13T15:29:38.141Z"}],"check-in-desks":{"location":"Apron","timestamp":"1958-09-09T06:57:37.747Z"}},"milestones":{"gto":{"scheduled":"1970-05-21T18:58:46.057Z","estimated":"1957-08-10T13:48:20.067Z","actual":"1966-09-29T18:03:29.858Z"},"gtc":{"scheduled":"1948-10-19T08:50:57.218Z","estimated":"2009-04-28T07:41:01.037Z","actual":"1959-05-16T22:10:42.298Z"},"obt":{"scheduled":"2022-01-27T04:18:22.985Z","estimated":"2009-12-02T20:03:57.320Z","actual":"2002-10-20T10:25:29.375Z"},"tot":{"scheduled":"1969-01-08T19:18:21.311Z","estimated":"1969-06-10T16:06:21.253Z","actual":"1959-07-22T20:43:02.918Z"},"ldt":{"scheduled":"1967-07-11T00:20:09.156Z","estimated":"1970-07-19T12:09:13.758Z","actual":"1980-10-08T02:30:43.200Z"},"ibt":{"scheduled":"1981-10-07T20:30:56.796Z","estimated":"1976-05-30T12:50:51.822Z","actual":"2014-01-06T01:47:28.598Z"}},"aircraft":{"timestamp":"1949-01-09T16:51:49.888Z","aircraft-type":"A320","registration-number":""}},{"id":"amet","identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"ea eiusmod anim quis","origin-date":"1985-09-09","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":true,"state":"DEPARTED","meta":{"created-at":"1969-03-20T16:31:49.074Z","created-by":{"user-id":"ut ex","user-name":"veniam"},"created-event-type":"pariatur eiusmod nulla amet reprehenderit","created-event-time":"1978-12-06T14:38:37.567Z","modified-count":-47184012,"modified-at":"1960-01-27T22:59:48.690Z","modified-by":{"user-id":"tempor sint","user-name":"aliqua"},"modified-event-type":"dolor nostrud anim","modified-event-time":"1976-03-12T23:42:45.450Z"},"secondary-identifiers":[{"created":"2006-05-29T06:49:28.550Z","identifier":"minim aute reprehenderit","source":"ea in dol"},{"created":"1958-09-14T04:58:38.748Z","identifier":"dolor velit consequat aut","source":"ipsum et sint adipisicing velit"}],"codeshares":[{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"dolor tempor nostrud","origin-date":"2012-04-08","origin-iata-code":"AAA","operational-suffix":"B"},{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"dolor m","origin-date":"1950-01-01","origin-iata-code":"AAA","operational-suffix":"B"}],"flight-segments":[{"identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"eu non ","origin-date":"2010-06-06","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":false,"secondary-identifiers":[{"created":"1980-04-06T01:27:19.161Z","identifier":"mollit culpa cupidat","source":"nisi sit eiusmo"},{"created":"1990-10-08T07:06:42.253Z","identifier":"dolor sed cul","source":"ea ut quis"}]},{"identifier":{"carrier":"ZZ","destination-iata-code":"ZZZ","flight-number":"997","identifier-string":"Lorem magna culpa fugiat minim","origin-date":"1968-09-02","origin-iata-code":"AAA","operational-suffix":"B"},"is-international":true,"secondary-identifiers":[{"created":"1998-09-16T09:06:55.668Z","identifier":"proident adipisicing Duis in laborum","source":"proident occaecat"},{"created":"2011-04-13T22:34:33.766Z","identifier":"voluptate id","source":"enim fugiat incididunt ut"}]}],"outbound-resources":{"aircraft-parking-position":{"location":"Apron","timestamp":"1953-07-28T07:39:44.132Z"},"passenger-gates":[{"location":"Apron","timestamp":"1974-07-16T16:41:39.086Z"},{"location":"Apron","timestamp":"1953-12-05T04:32:52.030Z"}],"remote-operational-gates":[{"location":"Apron","timestamp":"2000-03-27T19:55:47.668Z"},{"location":"Apron","timestamp":"1955-06-23T00:16:47.196Z"}],"runway":{"location":"Apron","timestamp":"1994-09-09T13:40:28.767Z"},"aircraft-terminal":{"location":"Apron","timestamp":"1988-06-20T22:04:16.060Z"},"public-terminals":[{"location":"Apron","timestamp":"1989-12-15T03:08:17.221Z"},{"location":"Apron","timestamp":"1976-02-21T08:23:41.708Z"}],"baggage-claim-units":[{"location":"Apron","timestamp":"1962-09-14T17:32:10.173Z"},{"location":"Apron","timestamp":"2023-01-24T16:14:17.525Z"}],"baggage-make-up-belts":[{"location":"Apron","timestamp":"1999-02-22T06:04:55.211Z"},{"location":"Apron","timestamp":"1959-10-03T13:11:54.189Z"}],"baggage-transfer-laterals":[{"location":"Apron","timestamp":"1976-09-13T22:54:17.426Z"},{"location":"Apron","timestamp":"1999-10-31T22:12:13.978Z"}],"check-in-desks":{"location":"Apron","timestamp":"1954-05-25T15:36:48.503Z"}},"inbound-resources":{"aircraft-parking-position":{"location":"Apron","timestamp":"1999-07-13T21:35:56.935Z"},"passenger-gates":[{"location":"Apron","timestamp":"2003-12-09T19:04:32.000Z"},{"location":"Apron","timestamp":"1948-01-19T20:29:15.774Z"}],"remote-operational-gates":[{"location":"Apron","timestamp":"2012-01-15T20:45:29.399Z"},{"location":"Apron","timestamp":"2016-06-16T08:29:00.673Z"}],"runway":{"location":"Apron","timestamp":"2020-03-27T09:06:42.384Z"},"aircraft-terminal":{"location":"Apron","timestamp":"1979-03-07T05:16:11.375Z"},"public-terminals":[{"location":"Apron","timestamp":"1970-03-15T23:13:44.428Z"},{"location":"Apron","timestamp":"1947-11-28T10:43:00.646Z"}],"baggage-claim-units":[{"location":"Apron","timestamp":"1949-06-06T15:53:52.083Z"},{"location":"Apron","timestamp":"1992-11-18T16:09:25.454Z"}],"baggage-make-up-belts":[{"location":"Apron","timestamp":"1966-12-06T07:17:17.681Z"},{"location":"Apron","timestamp":"1984-10-29T12:48:49.807Z"}],"baggage-transfer-laterals":[{"location":"Apron","timestamp":"2019-10-07T00:01:37.781Z"},{"location":"Apron","timestamp":"1998-11-08T06:50:05.303Z"}],"check-in-desks":{"location":"Apron","timestamp":"2001-01-17T04:08:02.844Z"}},"milestones":{"gto":{"scheduled":"2013-08-19T18:38:24.806Z","estimated":"1999-12-23T00:11:51.461Z","actual":"2022-08-01T05:24:05.290Z"},"gtc":{"scheduled":"2000-05-29T08:21:32.090Z","estimated":"1977-02-05T15:44:59.715Z","actual":"2003-03-02T08:17:19.427Z"},"obt":{"scheduled":"1949-10-30T18:08:38.981Z","estimated":"1969-12-25T05:51:56.905Z","actual":"1978-09-29T16:24:41.741Z"},"tot":{"scheduled":"1974-04-02T06:59:18.177Z","estimated":"1999-06-05T10:35:50.994Z","actual":"2001-08-13T22:28:13.781Z"},"ldt":{"scheduled":"1967-10-28T13:44:04.808Z","estimated":"1984-01-05T11:19:12.985Z","actual":"1950-06-05T01:34:33.205Z"},"ibt":{"scheduled":"1995-01-14T13:15:22.681Z","estimated":"1951-04-25T15:05:27.666Z","actual":"1959-09-02T04:20:08.987Z"}},"aircraft":{"timestamp":"1947-11-12T03:42:47.141Z","aircraft-type":"A320","registration-number":"veniam"}}]