--- title: "GET /udl/airevent/tuple" method: GET path: "/udl/airevent/tuple" tags: ["AirOperations"] --- # GET /udl/airevent/tuple `GET /udl/airevent/tuple` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/airevent/tuple` - Auth: none declared Service operation to dynamically query data and only return specified columns/fields. Requested columns are specified by the 'columns' query parameter and should be a comma separated list of valid fields for the specified data type. classificationMarking is always returned. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. An example URI: /udl/elset/tuple?columns=satNo,period&epoch=>now-5 hours would return the satNo and period of elsets with an epoch greater than 5 hours ago. ## Query parameters - `columns` string, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - AirEventFull[] - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `type` string, required: Type of air event (e.g. FUEL TRANSFER, AIR DROP, etc). - `idSortie` string: The UDL unique identifier of the sortie associated with this air event. - `idMission` string: The UDL unique identifier of the mission associated with this air event. - `externalAirEventId` string: Optional air event ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `legNum` integer: Identifies the Itinerary point of a sortie where an air event occurs. - `location` string: The location representing this air event specified as a feature Id. Locations specified include air refueling track Ids and air drop event locations. - `arrPurpose` string: The purpose of the air event at the arrival location. Can be either descriptive text such as 'fuel onload' or a purpose code specified by the provider, such as 'A'. - `plannedArrTime` string, date-time: The scheduled arrival time of the aircraft at the air event, in ISO 8601 UTC format with millisecond precision. - `estArrTime` string, date-time: The current estimated arrival time of the aircraft at the air event, in ISO 8601 UTC format with millisecond precision. - `actualArrTime` string, date-time: The actual arrival time of the aircraft at the air event, in ISO 8601 UTC format with millisecond precision. - `depPurpose` string: The purpose of the air event at the departure location. Can be either descriptive text such as 'fuel onload' or a purpose code specified by the provider, such as 'A'. - `plannedDepTime` string, date-time: The scheduled departure time of the aircraft from the air event, in ISO 8601 UTC format with millisecond precision. - `estDepTime` string, date-time: The current estimated departure time of the aircraft from the air event, in ISO 8601 UTC format with millisecond precision. - `actualDepTime` string, date-time: The actual departure time of the aircraft from the air event, in ISO 8601 UTC format with millisecond precision. - `externalARTrackId` string: Optional air refueling track ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `arTrackId` string: Identifier of the air refueling track, if applicable. - `arTrackName` string: Name of the air refueling track, if applicable. - `rzct` string, date-time: The Rendezvous Control Time is the planned time the tanker and receiver aircraft will rendezvous for an en route type air refueling event, in ISO 8601 UTC format, with millisecond precision. - `arct` string, date-time: The Air Refueling Control Time is the planned time the tanker aircraft will transfer fuel to the receiver aircraft, in ISO 8601 UTC format, with millisecond precision. - `baseAlt` number, double: Altitude of this air event, in feet. - `priority` string: Priority of this air event. - `trackTime` number, double: Length of time the receiver unit has requested for an air event, in hours. - `statusCode` string: Status of this air refueling event track reservation. Receivers are responsible for scheduling or reserving air refueling tracks. Possible values are A (Altitude Reservation), R (Reserved), or Q (Questionable). - `rzPoint` string: Rendezvous point for the tanker and receiver during this air refueling event. Possible values are AN (Anchor Nav Point), AP (Anchor Pattern), CP (Control Point), ET (Entry Point), EX (Exit Point), IP (Initial Point), NC (Nav Check Point). - `rzType` string: Type of rendezvous used for this air refueling event. Possible values are BUD (Buddy), EN (Enroute), GCI (Ground Control), PP (Point Parallel). - `arEventType` string: Type of process used by AMC to schedule this air refueling event. Possible values are A (Matched Long Range), F (Matched AMC Short Notice), N (Unmatched Theater Operation Short Notice (Theater Assets)), R, Unmatched Long Range, S (Soft Air Refueling), T (Matched Theater Operation Short Notice (Theater Assets)), V (Unmatched AMC Short Notice), X (Unmatched Theater Operation Short Notice (AMC Assets)), Y (Matched Theater Operation Short Notice (AMC Assets)), Z (Other Air Refueling). - `numTankers` integer: The number of tankers requested for an air refueling event. - `revTrack` boolean: Flag indicating if the receiver unit has requested flying an air refueling track in both directions. - `shortTrack` boolean: Flag indicating that the receiver unit has requested flying a short portion of an air refueling track. - `cancelled` boolean: Flag indicating that this air refueling event has been cancelled. - `tankers` AirEventTankersFull[]: Collection of tanker aircraft associated with this Air Event. - `idTankerSortie` string: The UDL ID of the aircraft sortie this tanker is associated with for this event. - `idTankerMission` string: The UDL ID of the mission this tanker is associated with for this event. - `idTankerAirfield` string: The UDL ID of the airfield this tanker is associated with for this event. - `externalTankerId` string: Optional tanker identifier from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `tankerCoord` string: Coordination record identifier of this tanker. - `tankerMDS` string: The Model Design Series designation of this tanker. - `amcTankerMissionId` string: The Air Mobility Command (AMC) mission identifier of this tanker. - `altTankerMissionId` string: Alternate mission identifier of this tanker provided by source. - `tankerCallSign` string: The call sign assigned to this tanker. - `tankerOwner` string: The wing or unit that owns this tanker. - `tankerPOC` string: The name and/or number of the point of contact for this tanker. - `tankerLegNum` integer: Identifies the itinerary point of a mission that this tanker is linked to. - `tankerDeployedICAO` string: Location the tanker has been deployed to in preparation for an air refueling event. - `tankerDeliveryMethod` string: Type of fuel delivery method used by the tanker during an air refueling event (BOOM, DROGUE, BOTH). - `fuelOff` number, double: Total weight of the fuel transferred from this tanker during an air refueling event, in pounds. - `tankerCellPosition` integer: Position of this tanker within a group of tankers in an air refueling event. - `tankerFuelType` string: Type of fuel being transferred from the tanker in an air refueling event. - `dualRole` boolean: Flag indicating that this tanker is flying a dual role mission in an air refueling event. - `receivers` AirEventReceiversFull[]: Collection of receiver aircraft associated with this Air Event. - `idReceiverSortie` string: The UDL ID of the aircraft sortie this receiver is associated with for this event. - `idReceiverMission` string: The UDL ID of the mission this receiver is associated with for this event. - `idReceiverAirfield` string: The UDL ID of the airfield this receiver is associated with for this event. - `externalReceiverId` string: Optional receiver identifier from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `receiverCoord` string: Coordination record identifier of this receiver. - `receiverMDS` string: The Model Design Series designation of this receiver. - `amcReceiverMissionId` string: The Air Mobility Command (AMC) mission identifier of this receiver. - `altReceiverMissionId` string: Alternate mission identifier of this receiver provided by source. - `receiverCallSign` string: The call sign assigned to this receiver. - `receiverOwner` string: The wing or unit that owns this receiver. - `receiverPOC` string: The name and/or number of the point of contact for this receiver. - `receiverLegNum` integer: Identifies the itinerary point of a mission that this receiver is linked to. - `receiverDeployedICAO` string: Location the receiver is deployed to for an air refueling event. - `receiverDeliveryMethod` string: Type of fuel delivery method used by the receiver during an air refueling event (BOOM, DROGUE, BOTH). - `fuelOn` number, double: Total weight of the fuel transferred to this receiver during an air refueling event, in pounds. - `receiverCellPosition` integer: Position of this receiver within a group of receivers in an air refueling event. - `sequenceNum` string: Indicates the unique number by Unit ID, which identifies an air refueling event. - `recOrg` string: The major command level (MAJCOM) or foreign military sales (FMS) name of the receiver's organization. The tanker flying hours used for an air refueling event are logged against the receiver MAJCOM or foreign government being supported. - `numRecAircraft` integer: Number of aircraft contained within one receiver coordination record for an air refueling event. - `receiverFuelType` string: Type of fuel being transferred to the receiver in an air refueling event. - `receiverExercise` string: Name of the receiver exercise associated with an air refueling event. - `packageId` string: The package identifier for the receiver in an air refueling event. - `remarks` AirEventRemarksFull[]: Collection of remarks associated with this Air Event. - `externalRemarkId` string: Optional remark ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `text` string: Text of the remark. - `date` string, date-time: Date the remark was published, in ISO 8601 UTC format, with millisecond precision. - `user` string: User who published the remark. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `updatedAt` string, date-time: Time the row was updated in the database, auto-populated by the system. - `updatedBy` string: Application user who updated the row in the database, auto-populated by the system. - `sourceDL` string: The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL. - `source` string, required: Source of the data. - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 2 info - api operation id `findAllTuples_1` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/airevent/tuple/get.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)