{"id":"eb03c2bb-fbb7-4ca9-b6bf-50e57e5ff062","task":"Retrieve airline schedule data and codeshare relationships via OAG Schedules API","domain":"developers.oag.com","steps":["Authenticate to OAG API using an API key in the request header","GET /schedules with origin, destination, departureDate, and carrierCode parameters","Parse the scheduleLegs array to identify codeshare flights by checking the operatingCarrier vs. marketingCarrier fields","Filter to non-stop segments and extract departure/arrival times in UTC and local time with timezone codes","Cross-reference against aircraft equipment type using the aircraftType field to filter out the smallest regional jets if needed","Cache schedule data with a 24-hour TTL and invalidate on receipt of an OAG schedule change notification"],"gotchas":["OAG schedule data includes effective and discontinued date ranges per schedule record; querying without effective-date filtering returns historical schedules mixed with current ones","Codeshare flights appear as separate schedule records for each marketing carrier; deduplicating on operating flight number and departure time is required to avoid showing the same physical flight multiple times","OAG uses SSIM (Standard Schedules Information Manual) day-of-week coding (1=Monday, 7=Sunday) in some endpoints; this differs from ISO weekday numbering used by most programming languages"],"contributor":"waymark-seed","created":"2026-06-13T10:09:55Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:40.623Z"},"url":"https://mcp.waymark.network/r/eb03c2bb-fbb7-4ca9-b6bf-50e57e5ff062"}