Aviation & Airport Operations Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/flight-schedule-normalize$0.03 USDC

Normalize flight schedules

Normalize caller-supplied flight schedule fields and compute delay/block times when actual times are present. Paid flight tracking is not used.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "airline": "British Airways",
      "airlineIata": "BA",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "aircraftType": "B777",
      "aircraftRegistration": "G-STBA",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "normalized",
  "flightCount": 1,
  "items": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "airline": "British Airways",
      "airlineIata": "BA",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "status": "delayed",
      "aircraftRegistration": "G-STBA",
      "aircraftType": "B777",
      "departureDelayMinutes": 40,
      "departureDelayMinutesSupplied": true,
      "arrivalDelayMinutes": 50,
      "arrivalDelayMinutesSupplied": true,
      "scheduledBlockMinutes": 480,
      "scheduledBlockMinutesSupplied": true,
      "actualBlockMinutes": 490,
      "actualBlockMinutesSupplied": true,
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/flight-schedule-normalize" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "airline": "British Airways",
      "airlineIata": "BA",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "aircraftType": "B777",
      "aircraftRegistration": "G-STBA",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/flight-delay-pattern-analyze$0.04 USDC

Analyze flight delay patterns

Aggregate delay statistics by flight number/route from caller-supplied scheduled and actual times.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-02T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-02T18:00:00.000Z",
      "actualDepartureAt": "2026-11-02T10:20:00.000Z",
      "actualArrivalAt": "2026-11-02T18:25:00.000Z",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "patternCount": 1,
  "items": [
    {
      "key": "BA100|LHR-JFK",
      "airline": "",
      "route": "LHR-JFK",
      "sampleCount": 2,
      "averageDelayMinutes": 37.5,
      "medianDelayMinutes": 50,
      "maxDelayMinutes": 50,
      "onTimeCount": 0,
      "lateCount": 2,
      "onTimePct": 0,
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/flight-delay-pattern-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-02T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-02T18:00:00.000Z",
      "actualDepartureAt": "2026-11-02T10:20:00.000Z",
      "actualArrivalAt": "2026-11-02T18:25:00.000Z",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/airport-connection-risk-calculate$0.04 USDC

Calculate airport connection risk

Calculate connection slack and risk from inbound/outbound caller-supplied flight times and minimum connect minutes.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA117",
      "origin": "JFK",
      "destination": "LHR",
      "scheduledDepartureAt": "2026-11-01T20:00:00.000Z",
      "actualDepartureAt": "2026-11-01T20:10:00.000Z",
      "source": "Caller-supplied"
    }
  ],
  "connections": [
    {
      "id": "C1",
      "inboundFlightId": "F1",
      "outboundFlightId": "F2",
      "airport": "JFK",
      "minimumConnectMinutes": 90,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "connectionCount": 1,
  "highRiskCount": 1,
  "items": [
    {
      "id": "C1",
      "airport": "JFK",
      "inboundFlightId": "F1",
      "outboundFlightId": "F2",
      "inboundFlightNumber": "BA100",
      "outboundFlightNumber": "BA117",
      "availableConnectMinutes": 80,
      "minimumConnectMinutes": 90,
      "slackMinutes": -10,
      "risk": "missed",
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "connection_risk",
      "subject": "C1",
      "detail": "Connection slack -10 minutes is missed."
    }
  ],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/airport-connection-risk-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA117",
      "origin": "JFK",
      "destination": "LHR",
      "scheduledDepartureAt": "2026-11-01T20:00:00.000Z",
      "actualDepartureAt": "2026-11-01T20:10:00.000Z",
      "source": "Caller-supplied"
    }
  ],
  "connections": [
    {
      "id": "C1",
      "inboundFlightId": "F1",
      "outboundFlightId": "F2",
      "airport": "JFK",
      "minimumConnectMinutes": 90,
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/flight-diversion-event-track$0.03 USDC

Track flight diversion events

Normalize caller-supplied diversion events and durations. Live paid tracking feeds are not queried.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "diversions": [
    {
      "id": "D1",
      "flightNumber": "BA100",
      "plannedDestination": "JFK",
      "diversionAirport": "BOS",
      "divertedAt": "2026-11-01T16:00:00.000Z",
      "reason": "weather",
      "resumedAt": "2026-11-01T19:00:00.000Z",
      "finalDestination": "JFK",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "tracked",
  "eventCount": 1,
  "activeCount": 0,
  "items": [
    {
      "id": "D1",
      "flightId": "",
      "flightNumber": "BA100",
      "plannedDestination": "JFK",
      "diversionAirport": "BOS",
      "divertedAt": "2026-11-01T16:00:00.000Z",
      "reason": "weather",
      "resumedAt": "2026-11-01T19:00:00.000Z",
      "finalDestination": "JFK",
      "diversionDurationMinutes": 180,
      "diversionDurationMinutesSupplied": true,
      "active": false,
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/flight-diversion-event-track" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "diversions": [
    {
      "id": "D1",
      "flightNumber": "BA100",
      "plannedDestination": "JFK",
      "diversionAirport": "BOS",
      "divertedAt": "2026-11-01T16:00:00.000Z",
      "reason": "weather",
      "resumedAt": "2026-11-01T19:00:00.000Z",
      "finalDestination": "JFK",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/aircraft-registration-lookup$0.03 USDC

Look up aircraft registrations

Normalize caller-supplied aircraft registration records, optionally enriched with key-free OpenSky aircraft metadata when openSky.icao24 is requested.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "registrations": [
    {
      "id": "R1",
      "registration": "G-STBA",
      "aircraftType": "B777",
      "manufacturer": "Boeing",
      "model": "777-300ER",
      "operator": "British Airways",
      "country": "UK",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "looked_up",
  "aircraftCount": 1,
  "items": [
    {
      "id": "R1",
      "registration": "G-STBA",
      "icao24": "",
      "aircraftType": "B777",
      "manufacturer": "Boeing",
      "model": "777-300ER",
      "operator": "British Airways",
      "owner": "",
      "country": "UK",
      "serialNumber": "",
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false,
      "authenticatedAirlineSystemUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/aircraft-registration-lookup" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "registrations": [
    {
      "id": "R1",
      "registration": "G-STBA",
      "aircraftType": "B777",
      "manufacturer": "Boeing",
      "model": "777-300ER",
      "operator": "British Airways",
      "country": "UK",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/aircraft-maintenance-log-parse$0.04 USDC

Parse aircraft maintenance logs

Parse caller-supplied maintenance log rows into normalized task entries and open-item flags.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "maintenanceLogs": [
    {
      "id": "M1",
      "registration": "G-STBA",
      "at": "2026-10-01",
      "taskCode": "A-CHK",
      "description": "A check",
      "hours": 12,
      "status": "closed",
      "source": "Caller-supplied"
    },
    {
      "id": "M2",
      "registration": "G-STBA",
      "at": "2026-11-01",
      "taskCode": "DEF-1",
      "description": "Deferred item",
      "status": "open",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "parsed",
  "entryCount": 2,
  "openCount": 1,
  "items": [
    {
      "id": "M1",
      "registration": "G-STBA",
      "at": "2026-10-01",
      "taskCode": "A-CHK",
      "description": "A check",
      "hours": 12,
      "hoursSupplied": true,
      "cycles": 0,
      "cyclesSupplied": false,
      "status": "closed",
      "open": false,
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    },
    {
      "id": "M2",
      "registration": "G-STBA",
      "at": "2026-11-01",
      "taskCode": "DEF-1",
      "description": "Deferred item",
      "hours": 0,
      "hoursSupplied": false,
      "cycles": 0,
      "cyclesSupplied": false,
      "status": "open",
      "open": true,
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/aircraft-maintenance-log-parse" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "maintenanceLogs": [
    {
      "id": "M1",
      "registration": "G-STBA",
      "at": "2026-10-01",
      "taskCode": "A-CHK",
      "description": "A check",
      "hours": 12,
      "status": "closed",
      "source": "Caller-supplied"
    },
    {
      "id": "M2",
      "registration": "G-STBA",
      "at": "2026-11-01",
      "taskCode": "DEF-1",
      "description": "Deferred item",
      "status": "open",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/document-expiry-check$0.03 USDC

Check aviation document expiry

Compare caller-supplied document expiry dates to asOf and flag expired or soon-expiring items. Regulatory compliance is not determined.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "documents": [
    {
      "id": "DOC1",
      "subject": "CoA",
      "documentType": "certificate",
      "registration": "G-STBA",
      "issuedAt": "2025-01-01",
      "expiresAt": "2026-11-20",
      "source": "Caller-supplied"
    },
    {
      "id": "DOC2",
      "subject": "Insurance",
      "documentType": "insurance",
      "registration": "G-STBA",
      "expiresAt": "2026-10-01",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "checked",
  "documentCount": 2,
  "expiredCount": 1,
  "expiringSoonCount": 1,
  "items": [
    {
      "id": "DOC1",
      "subject": "CoA",
      "documentType": "certificate",
      "registration": "G-STBA",
      "issuedAt": "2025-01-01",
      "expiresAt": "2026-11-20",
      "daysRemaining": 15.125,
      "daysRemainingSupplied": true,
      "status": "expiring_soon",
      "regulatoryComplianceDetermined": false,
      "source": "Caller-supplied"
    },
    {
      "id": "DOC2",
      "subject": "Insurance",
      "documentType": "insurance",
      "registration": "G-STBA",
      "issuedAt": "",
      "expiresAt": "2026-10-01",
      "daysRemaining": -34.875,
      "daysRemainingSupplied": true,
      "status": "expired",
      "regulatoryComplianceDetermined": false,
      "source": "Caller-supplied"
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "document_expiry",
      "subject": "DOC1",
      "detail": "Document is expiring_soon (15.125 days from asOf)."
    },
    {
      "kind": "conflict",
      "code": "document_expiry",
      "subject": "DOC2",
      "detail": "Document is expired (-34.875 days from asOf)."
    }
  ],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/document-expiry-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "documents": [
    {
      "id": "DOC1",
      "subject": "CoA",
      "documentType": "certificate",
      "registration": "G-STBA",
      "issuedAt": "2025-01-01",
      "expiresAt": "2026-11-20",
      "source": "Caller-supplied"
    },
    {
      "id": "DOC2",
      "subject": "Insurance",
      "documentType": "insurance",
      "registration": "G-STBA",
      "expiresAt": "2026-10-01",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/flight-emissions-estimate$0.04 USDC

Estimate flight emissions

Estimate CO2 from caller-supplied fuel burn or distance with caller emission factors, falling back to a disclosed public-style factor table only when neither is supplied.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "aircraftType": "B777",
      "distanceKm": 5540,
      "passengers": 250,
      "source": "Caller-supplied"
    }
  ],
  "emissionFactors": [
    {
      "aircraftType": "B777",
      "kgCo2PerKm": 22,
      "source": "Caller-supplied factor"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "estimated",
  "flightCount": 1,
  "totalKgCo2": 121880,
  "items": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "aircraftType": "B777",
      "distanceKm": 5540,
      "distanceKmSupplied": true,
      "fuelBurnKg": 0,
      "fuelBurnKgSupplied": false,
      "kgCo2": 121880,
      "kgCo2Supplied": true,
      "kgCo2PerPassenger": 487.52,
      "kgCo2PerPassengerSupplied": true,
      "method": "caller_kgco2_per_km",
      "factorSource": "Caller-supplied factor",
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/flight-emissions-estimate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "aircraftType": "B777",
      "distanceKm": 5540,
      "passengers": 250,
      "source": "Caller-supplied"
    }
  ],
  "emissionFactors": [
    {
      "aircraftType": "B777",
      "kgCo2PerKm": 22,
      "source": "Caller-supplied factor"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/airport-ground-time-analyze$0.03 USDC

Analyze airport ground time

Analyze caller-supplied arrival/departure ground times against scheduled turn times.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "groundTimes": [
    {
      "id": "G1",
      "airport": "JFK",
      "flightNumber": "BA100",
      "arrivalAt": "2026-11-01T18:50:00.000Z",
      "departureAt": "2026-11-01T20:10:00.000Z",
      "scheduledGroundMinutes": 60,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "sampleCount": 1,
  "extendedCount": 1,
  "items": [
    {
      "id": "G1",
      "airport": "JFK",
      "flightNumber": "BA100",
      "registration": "",
      "arrivalAt": "2026-11-01T18:50:00.000Z",
      "departureAt": "2026-11-01T20:10:00.000Z",
      "actualGroundMinutes": 80,
      "actualGroundMinutesSupplied": true,
      "scheduledGroundMinutes": 60,
      "scheduledGroundMinutesSupplied": true,
      "varianceMinutes": 20,
      "varianceMinutesSupplied": true,
      "extended": true,
      "source": "Caller-supplied",
      "paidFlightTrackingUsed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/airport-ground-time-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "groundTimes": [
    {
      "id": "G1",
      "airport": "JFK",
      "flightNumber": "BA100",
      "arrivalAt": "2026-11-01T18:50:00.000Z",
      "departureAt": "2026-11-01T20:10:00.000Z",
      "scheduledGroundMinutes": 60,
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/aviation-intelligence/operations-report$0.08 USDC

Build aviation operations report

Aggregate schedule normalization, delay patterns, connection risk, diversions, registrations, maintenance, document expiry, emissions, and ground time from caller-supplied records only.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`flights`	No	array; Array
`diversions`	No	array; Array
`registrations`	No	array; Array
`maintenanceLogs`	No	array; Array
`documents`	No	array; Array
`groundTimes`	No	array; Array
`emissionFactors`	No	array; Array
`connections`	No	array; Array
`openSky`	No	object; Object
`asOf`	No	string
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "airlineIata": "BA",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "aircraftType": "B777",
      "aircraftRegistration": "G-STBA",
      "distanceKm": 5540,
      "passengers": 250,
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA117",
      "airlineIata": "BA",
      "origin": "JFK",
      "destination": "LHR",
      "scheduledDepartureAt": "2026-11-01T20:00:00.000Z",
      "scheduledArrivalAt": "2026-11-02T07:00:00.000Z",
      "actualDepartureAt": "2026-11-01T20:10:00.000Z",
      "actualArrivalAt": "2026-11-02T07:05:00.000Z",
      "aircraftType": "B777",
      "distanceKm": 5540,
      "source": "Caller-supplied"
    }
  ],
  "connections": [
    {
      "id": "C1",
      "inboundFlightId": "F1",
      "outboundFlightId": "F2",
      "airport": "JFK",
      "minimumConnectMinutes": 90,
      "source": "Caller-supplied"
    }
  ],
  "diversions": [
    {
      "id": "D1",
      "flightNumber": "BA100",
      "plannedDestination": "JFK",
      "diversionAirport": "BOS",
      "divertedAt": "2026-11-01T16:00:00.000Z",
      "resumedAt": "2026-11-01T19:00:00.000Z",
      "reason": "weather",
      "source": "Caller-supplied"
    }
  ],
  "registrations": [
    {
      "id": "R1",
      "registration": "G-STBA",
      "aircraftType": "B777",
      "manufacturer": "Boeing",
      "operator": "British Airways",
      "source": "Caller-supplied"
    }
  ],
  "maintenanceLogs": [
    {
      "id": "M2",
      "registration": "G-STBA",
      "taskCode": "DEF-1",
      "description": "Deferred item",
      "status": "open",
      "source": "Caller-supplied"
    }
  ],
  "documents": [
    {
      "id": "DOC1",
      "subject": "CoA",
      "documentType": "certificate",
      "registration": "G-STBA",
      "expiresAt": "2026-11-20",
      "source": "Caller-supplied"
    }
  ],
  "groundTimes": [
    {
      "id": "G1",
      "airport": "JFK",
      "flightNumber": "BA100",
      "arrivalAt": "2026-11-01T18:50:00.000Z",
      "departureAt": "2026-11-01T20:10:00.000Z",
      "scheduledGroundMinutes": 60,
      "source": "Caller-supplied"
    }
  ],
  "emissionFactors": [
    {
      "aircraftType": "B777",
      "kgCo2PerKm": 22,
      "source": "Caller-supplied factor"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "reported",
  "asOf": "2026-11-04T21:00:00.000Z",
  "sections": {
    "schedule": {
      "flightCount": 2
    },
    "delayPatterns": {
      "patternCount": 2
    },
    "connections": {
      "connectionCount": 1,
      "highRiskCount": 1
    },
    "diversions": {
      "eventCount": 1,
      "activeCount": 0
    },
    "registrations": {
      "aircraftCount": 1
    },
    "maintenance": {
      "entryCount": 1,
      "openCount": 1
    },
    "documents": {
      "documentCount": 1,
      "expiredCount": 0,
      "expiringSoonCount": 1
    },
    "emissions": {
      "flightCount": 2,
      "totalKgCo2": 243760
    },
    "groundTime": {
      "sampleCount": 1,
      "extendedCount": 1
    }
  },
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidFlightTrackingUsed": false,
  "authenticatedAirlineSystemUsed": false,
  "openSkyFetched": false,
  "findings": [],
  "limitations": [
    "Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.",
    "No paid flight-tracking API or authenticated airline system is used and no API key is required.",
    "Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).",
    "Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.",
    "Operations reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/aviation-intelligence/operations-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "flights": [
    {
      "id": "F1",
      "flightNumber": "BA100",
      "airlineIata": "BA",
      "origin": "LHR",
      "destination": "JFK",
      "scheduledDepartureAt": "2026-11-01T10:00:00.000Z",
      "scheduledArrivalAt": "2026-11-01T18:00:00.000Z",
      "actualDepartureAt": "2026-11-01T10:40:00.000Z",
      "actualArrivalAt": "2026-11-01T18:50:00.000Z",
      "aircraftType": "B777",
      "aircraftRegistration": "G-STBA",
      "distanceKm": 5540,
      "passengers": 250,
      "source": "Caller-supplied"
    },
    {
      "id": "F2",
      "flightNumber": "BA117",
      "airlineIata": "BA",
      "origin": "JFK",
      "destination": "LHR",
      "scheduledDepartureAt": "2026-11-01T20:00:00.000Z",
      "scheduledArrivalAt": "2026-11-02T07:00:00.000Z",
      "actualDepartureAt": "2026-11-01T20:10:00.000Z",
      "actualArrivalAt": "2026-11-02T07:05:00.000Z",
      "aircraftType": "B777",
      "distanceKm": 5540,
      "source": "Caller-supplied"
    }
  ],
  "connections": [
    {
      "id": "C1",
      "inboundFlightId": "F1",
      "outboundFlightId": "F2",
      "airport": "JFK",
      "minimumConnectMinutes": 90,
      "source": "Caller-supplied"
    }
  ],
  "diversions": [
    {
      "id": "D1",
      "flightNumber": "BA100",
      "plannedDestination": "JFK",
      "diversionAirport": "BOS",
      "divertedAt": "2026-11-01T16:00:00.000Z",
      "resumedAt": "2026-11-01T19:00:00.000Z",
      "reason": "weather",
      "source": "Caller-supplied"
    }
  ],
  "registrations": [
    {
      "id": "R1",
      "registration": "G-STBA",
      "aircraftType": "B777",
      "manufacturer": "Boeing",
      "operator": "British Airways",
      "source": "Caller-supplied"
    }
  ],
  "maintenanceLogs": [
    {
      "id": "M2",
      "registration": "G-STBA",
      "taskCode": "DEF-1",
      "description": "Deferred item",
      "status": "open",
      "source": "Caller-supplied"
    }
  ],
  "documents": [
    {
      "id": "DOC1",
      "subject": "CoA",
      "documentType": "certificate",
      "registration": "G-STBA",
      "expiresAt": "2026-11-20",
      "source": "Caller-supplied"
    }
  ],
  "groundTimes": [
    {
      "id": "G1",
      "airport": "JFK",
      "flightNumber": "BA100",
      "arrivalAt": "2026-11-01T18:50:00.000Z",
      "departureAt": "2026-11-01T20:10:00.000Z",
      "scheduledGroundMinutes": 60,
      "source": "Caller-supplied"
    }
  ],
  "emissionFactors": [
    {
      "aircraftType": "B777",
      "kgCo2PerKm": 22,
      "source": "Caller-supplied factor"
    }
  ]
}
JSON