Method: batchGetAttributions

Gets multiple contrail attributions by flight information.

If successful, the response will be a list of contrail attributions.

HTTP request

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource shared by all attributions being retrieved. Format: attributions

Query parameters

Parameters
names[]

string

Required. The resource names of the flights to retrieve. A maximum of 100 names can be provided in a single request.

Format:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Components:

  • {carrier}: 2-character IATA carrier code (e.g., "AA", "UA").
  • {flightNumber}: 1-4 digit flight number (e.g., "123").
  • {departure_date}: Flight departure date in YYYY-MM-DD format.
  • {departure_airport}: 3-letter IATA airport code (e.g., "JFK", "LHR").

Request body

The request body must be empty.

Response body

Response which contains the attributed contrails for attributions.batchGet.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Fields
attributions[]

object (Attribution)

A list of attributions one for each resource name specified in the BatchGetAttributionsRequest.names. The order of attributions in this list will match the order of names in the BatchGetAttributionsRequest. If a flight was not found, the corresponding Attribution message in the response will only have the name field populated, while flightDetails and contrail will be empty.

Attribution

Represents an aggregated contrail event for a specific flight summarizing all attributed contrail segments (e.g., total kilometers and energy).

JSON representation 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
Fields
name

string

Identifier. The resource name of the flight.

Format:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Components:

  • {carrier}: 2-character IATA carrier code (e.g., "AA", "UA").
  • {flightNumber}: 1-4 digit flight number (e.g., "123").
  • {departure_date}: Flight departure date in YYYY-MM-DD format.
  • {departure_airport}: 3-letter IATA airport code (e.g., "JFK", "LHR").
flightDetails

object (FlightDetails)

The detail information for this flight.
contrail

object (ContrailAttributes)

Details about attributed contrails for the flight.

State interpretation (within a found flight):

  • If present: Contrail analysis was performed. The fields inside ContrailAttributes indicate the results (e.g., lengthMeters > 0 means contrails were attributed).
  • If absent: Contrail analysis could NOT be performed for this flight.
    • This is typically due to insufficient input data (e.g., missing weather data or flight path uncertainty).
    • This does NOT mean no contrails were formed, only that a determination could not be made.

FlightDetails

Defines the full set of flight information returned in the response.

JSON representation 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
Fields
carrier

string

IATA carrier code of the flight (e.g. "AA").
flightNumber

integer

Flight number of the flight (e.g. "123").
departureTime

string

Departure date in the origin airport's timezone int: unix epoch; str: ISO 8601.
icao24

string

ICAO 24-bit aircraft address
originAirport

string

IATA origin airport code.
destinationAirport

string

IATA destination airport code.
callSign

string

Callsign of the aircraft associated with the waypoint.
analyzedFlightDistanceMeters

string (int64 format)

Distance of the flight analyzed, in meters.

ContrailAttributes

Represents the contrail attributes for a flight.

JSON representation 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
Fields
lengthMeters

string (int64 format)

Estimated length of contrail formation, in meters.
effectiveEnergyForcingJoules

string (int64 format)

Total effective energy forcing attributed to this flight, in joules.