{"info":{"description":"Use this API to estimate cosmic radiation exposures of aircrew, directly from your business processes like rostering and record keeping. Estimate dose at a point, along a great circle route (constant altitude or stepclimb), or  higher accuracy calculations using recorded flight-track data. \n \nAll radiation doses are calculated as the quantity Effective Dose in units of microsieverts (denoted by \"uSv\"). If you require values in other units (such as millisieverts denoted by \"mSv\"),  you will need to perform the conversion. For example, 1 uSv = 0.001 mSv, so to convert to millisieverts you will need to multiply values by 0.001. \n<br><br> Use the CARI7 model for routine commercial flight dose estimation. Developed by the US Federal Aviation Administration's  Civil Aerospace Medical Institute, CARI7 calculates cosmic  ray doses in the atmosphere. See <a href=\"https://academic.oup.com/rpd/article/175/4/419/2884614\">here</a> for a complete description of  CARI-7. The original source code and Terms and Conditions can be found <a href=\"https://www.faa.gov/data_research/research/med_humanfacs/aeromedical/radiobiology/cari7/\">here</a>\n<br><br> CARI7 calculated dose is considered a monthly average accounting for heliocentric potential (HP) modulation only, minor geomagnetic storm and forbush decrease corrections are ignored. The calculation relies on HP data from the US Federal Aviation Administration that is released periodically. We perform our own predictions of this HP value using Machine Learning and real-time data to guarantee a forecast horizon of 2 months. If predictions are used, a flag is set in the response. Recalculation is recommended once official HP modulation indices are released. <br><br>\nUse the optional NAIRAS model for real-time operational monitoring and solar storm response.  The point, route, and flighttrack endpoints also accept `model=nairas`. NAIRAS is a NASA radiation environment model that provides nowcast effective-dose data for the atmosphere.  Amentum's NAIRAS data pipeline downloads the hourly NASA effective-dose dataset, transforms to a web data format, and caches in amentum cloud storage. The API samples that dataset using linear interpolation in altitude, latitude, and longitude, with nearest-neighbour fallback when interpolation returns a non-finite value. Route requests currently use the route date at 00:00 UTC for all generated waypoints; duration controls route integration, not NAIRAS dataset-hour selection. If NAIRAS metadata indicates a solar energetic particle event, the response `is_sep` flag is set. NAIRAS storage may lag current UTC by up to two hours. <br><br>\nWe acknowledge the Community Coordinated Modeling Center (CCMC) at Goddard Space Flight Center for the use of the NAIRAS, details <a href=\"https://ccmc.gsfc.nasa.gov/models/NAIRAS~3.0/\">here</a>.\n<br><br>\nAPI requests must contain a key \"API-Key\" in the header (see code samples). <br><br> \nVisit our <Button to='#' transparent><a href='https://developer.amentum.io'>Developer Portal</a></Button> to obtain an API key with a 14 day free trial and for support.<br><br> \nAmentum Pty Ltd is not responsible nor liable for any loss or damage of any sort incurred as a result of using the API. <br><br>\nCopyright <a href='https://amentum.space'>Amentum Pty Ltd</a> 2026.\n","title":"Aviation Radiation API","version":"2.0.0","x-logo":{"altText":"Amentum Aerospace","backgroundColor":"#FFFFFF","url":"https://amentum.io/static/img/AMENTUMSPACE_GREY_SMALL.jpg"}},"openapi":"3.0.0","paths":{"/cari7/effective_dose":{"get":{"deprecated":true,"description":"Deprecated compatibility endpoint for released clients. This endpoint uses the default CARI-7 model. Use GET /point for new integrations.\n","operationId":"app.api_point.endpoints.CARI7.effective_dose","parameters":[{"description":"Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).","in":"query","name":"altitude","required":true,"schema":{"example":11,"type":"number"}},{"description":"Latitude. -90 (S) to 90 (N).","in":"query","name":"latitude","required":true,"schema":{"example":30,"type":"number"}},{"description":"Longitude. -180 (W) to 180 (E).","in":"query","name":"longitude","required":true,"schema":{"example":30,"type":"number"}},{"description":"Year in YYYY.","in":"query","name":"year","required":true,"schema":{"example":2019,"type":"integer"}},{"description":"Month in MM.","in":"query","name":"month","required":true,"schema":{"example":12,"type":"integer"}},{"description":"Day in DD.","in":"query","name":"day","required":true,"schema":{"example":1,"type":"integer"}},{"description":"Hour in 24 hour time.","in":"query","name":"utc","required":true,"schema":{"example":3,"type":"integer"}},{"description":"The particle type as a string. Specifying 'total' returns the dose for all particle types.\n","in":"query","name":"particle","required":true,"schema":{"enum":["total","neutron","photon","e-","e+","mu-","mu+","proton","pi-","pi+","deuteron","triton","helion","alpha","Li","Be","B","C","N","O","F","Ne","Na","Mg","Al","Si","P","S","Cl","Ar","K","Ca","Sc","Ti","V","Cr","Mn","Fe"],"example":"total","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"dose rate":{"is_prediction":false,"is_sep":false,"model":"cari7","units":"uSv/hr","value":2.1532952875056712}},"properties":{"dose rate":{"properties":{"is_prediction":{"description":"Whether the calculation is based on predicted heliocentric potentials.","type":"boolean"},"is_sep":{"description":"Whether the calculation uses data flagged as a solar energetic particle event.","type":"boolean"},"model":{"enum":["cari7","nairas"],"type":"string"},"units":{"description":"Units of the radiation dose rate.","type":"string"},"value":{"description":"Radiation dose rate value.","type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful dose calculation"}},"summary":"Deprecated. Use GET /point.","tags":["point"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://avrad.amentum.io/cari7/effective_dose?altitude=11&latitude=30&longitude=30&year=2019&month=12&day=1&utc=3&particle=total\"  -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}},"/flighttrack":{"get":{"description":"Estimates effective dose along an aircraft's observed flight track  using recorded waypoint data. Dose rates are evaluated at each waypoint and integrated across the flight using the recorded time intervals between waypoints. The year, month, and day query parameters identify the flight's UTC departure date. The response includes only flights detected as departing on that UTC date; flight IDs whose first available point is already mid-air are excluded. Flights that depart on the requested UTC date and arrive after midnight UTC are reconstructed across both UTC dates when the next day's waypoint data is available.\n","operationId":"app.api_flighttrack.endpoints.FlightTrack.flighttrack","parameters":[{"description":"Year in YYYY.","in":"query","name":"year","required":true,"schema":{"example":2026,"type":"integer"}},{"description":"Month in MM.","in":"query","name":"month","required":true,"schema":{"example":4,"type":"integer"}},{"description":"Day in DD for the flight's UTC departure date.","in":"query","name":"day","required":true,"schema":{"example":14,"type":"integer"}},{"description":"Hexadecimal ICAO 24-bit aircraft address used for flight-track lookup.","in":"query","name":"icao_address","required":true,"schema":{"example":"7C8071","type":"string"}},{"description":"Radiation model to use. `cari7` uses the existing CARI-7 calculation. `nairas` uses hourly NAIRAS effective-dose zarr datasets stored in S3 and samples retained flight-track waypoints using each waypoint's UTC timestamp hour. Lookup uses linear interpolation in altitude, latitude, and longitude, with nearest-neighbour fallback when interpolation returns a non-finite value.\n","in":"query","name":"model","required":false,"schema":{"default":"cari7","enum":["cari7","nairas"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"dose":{"properties":{"date":{"example":"01/05/2024","type":"string"},"flight_identifier":{"description":"Flight number.","example":"QFA62","type":"string"},"icao_address":{"description":"Hexadecimal ICAO 24-bit aircraft address.","example":"7C6D39","type":"string"},"is_prediction":{"example":false,"type":"boolean"},"is_sep":{"description":"Whether any sampled flight-track waypoint uses data flagged as a solar energetic particle event.","example":false,"type":"boolean"},"model":{"enum":["cari7","nairas"],"type":"string"},"units":{"example":"uSv","type":"string"},"value":{"example":12.3,"type":"number"}},"type":"object"},"waypoints":{"description":"Retained flight-track waypoints used for integration, with the calculated dose rate at each waypoint.\n","items":{"properties":{"altitude":{"description":"Altitude in kilometres.","example":10.668,"type":"number"},"altitude_units":{"example":"km","type":"string"},"dose_rate":{"example":3.4,"type":"number"},"dose_rate_units":{"example":"uSv/hr","type":"string"},"latitude":{"example":-33.9461,"type":"number"},"longitude":{"example":151.1772,"type":"number"},"utc_time":{"example":"2026-04-14T00:00:00Z","format":"date-time","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}}},"description":"Successful flight-track dose calculation"}},"summary":"Calculate effective dose along recorded flight-track waypoints.","tags":["flighttrack"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://avrad.amentum.io/flighttrack?year=2026&month=4&day=14&icao_address=7C8071&model=cari7\"  -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}},"/point":{"get":{"description":"Estimates effective dose rate at a point in the atmosphere defined by\n latitude, longitude, altitude, and time. Dose rates can be evaluated \n for a specific particle type or for the total radiation field across \n all particle types.\n","operationId":"app.api_point.endpoints.CARI7.point","parameters":[{"description":"Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).","in":"query","name":"altitude","required":true,"schema":{"example":11,"type":"number"}},{"description":"Latitude. -90 (S) to 90 (N).","in":"query","name":"latitude","required":true,"schema":{"example":30,"type":"number"}},{"description":"Longitude. -180 (W) to 180 (E).","in":"query","name":"longitude","required":true,"schema":{"example":30,"type":"number"}},{"description":"Year in YYYY.","in":"query","name":"year","required":true,"schema":{"example":2019,"type":"integer"}},{"description":"Month in MM.","in":"query","name":"month","required":true,"schema":{"example":12,"type":"integer"}},{"description":"Day in DD.","in":"query","name":"day","required":true,"schema":{"example":1,"type":"integer"}},{"description":"Hour in 24 hour time.","in":"query","name":"utc","required":true,"schema":{"example":3,"type":"integer"}},{"description":"The particle type as a string. Specifying 'total' returns the dose for all particle types.\n","in":"query","name":"particle","required":true,"schema":{"enum":["total","neutron","photon","e-","e+","mu-","mu+","proton","pi-","pi+","deuteron","triton","helion","alpha","Li","Be","B","C","N","O","F","Ne","Na","Mg","Al","Si","P","S","Cl","Ar","K","Ca","Sc","Ti","V","Cr","Mn","Fe"],"example":"total","type":"string"}},{"description":"Radiation model to use. `cari7` uses the existing CARI-7 calculation. `nairas` uses the hourly NAIRAS effective-dose zarr dataset stored in S3 for the supplied UTC hour. Lookup uses linear interpolation in altitude, latitude, and longitude, with nearest-neighbour fallback when interpolation returns a non-finite value.\n","in":"query","name":"model","required":false,"schema":{"default":"cari7","enum":["cari7","nairas"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"dose rate":{"is_prediction":false,"is_sep":false,"model":"cari7","units":"uSv/hr","value":2.1532952875056712}},"properties":{"dose rate":{"properties":{"is_prediction":{"description":"Whether the calculation is based on predicted heliocentric potentials.","type":"boolean"},"is_sep":{"description":"Whether the calculation uses data flagged as a solar energetic particle event.","type":"boolean"},"model":{"enum":["cari7","nairas"],"type":"string"},"units":{"description":"Units of the radiation dose rate.","type":"string"},"value":{"description":"Radiation dose rate value.","type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful dose calculation"}},"summary":"Calculate effective dose rate at a point.","tags":["point"],"x-codeSamples":[{"lang":"Shell","source":"curl -X GET \"https://avrad.amentum.io/point?altitude=11&latitude=30&longitude=30&year=2019&month=12&day=1&utc=3&particle=total&model=cari7\"  -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}},"/route":{"get":{"description":"Calculates effective dose for a planned route between two airports or  latitude/longitude pairs. The flight path is modelled as a great-circle  route, with either a constant altitude and duration or a step-climb  profile. Dose rates are evaluated at each waypoint and integrated over  the route to estimate the total effective dose.\n","operationId":"app.api_route.endpoints.Route.route","parameters":[{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the origin airport.","in":"query","name":"origin","required":true,"schema":{"example":"YSSY","type":"string"}},{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination airport.","in":"query","name":"destination","required":true,"schema":{"example":"33.94250107,-118.4079971","type":"string"}},{"description":"Altitude (in km). The minimum is 0 m, the maximum is 20 km.","in":"query","name":"altitude","required":false,"schema":{"example":10.1,"type":"number"}},{"description":"The flight duration in hours. The minimum is 0, the maximum is 20 hrs.","in":"query","name":"duration","required":false,"schema":{"example":5,"type":"number"}},{"description":"Initial altitude (in km) for a step climb. The minimum is 0 m, the maximum is 20 km.","in":"query","name":"initial_altitude","required":false,"schema":{"example":0.0,"type":"number"}},{"description":"Cruising altitudes (in km) for a step climb. The minimum is 0 m, the maximum is 20 km.","in":"query","name":"cruising_altitudes","required":false,"schema":{"example":[10.0,10.5,11.0],"items":{"type":"number"},"type":"array"}},{"description":"Climb times for each cruising altitude (in hours) for a step climb.","in":"query","name":"climb_times","required":false,"schema":{"example":[0.1,0.5,0.4],"items":{"type":"number"},"type":"array"}},{"description":"Cruising times at each cruising altitude (in hours) for a step climb.","in":"query","name":"cruising_times","required":false,"schema":{"example":[1.0,2.0,3.0],"items":{"type":"number"},"type":"array"}},{"description":"Descent time from last cruising altitude to final altitude (in hours) for a step climb.","in":"query","name":"descent_time","required":false,"schema":{"example":0.5,"type":"number"}},{"description":"Final altitude (in km) for a step climb.","in":"query","name":"final_altitude","required":false,"schema":{"example":0.0,"type":"number"}},{"description":"Year in YYYY.","in":"query","name":"year","required":true,"schema":{"example":2019,"type":"integer"}},{"description":"Month in MM.","in":"query","name":"month","required":true,"schema":{"example":5,"type":"integer"}},{"description":"Day in DD.","in":"query","name":"day","required":true,"schema":{"example":21,"type":"integer"}},{"description":"Radiation model to use. `cari7` uses the existing CARI-7 calculation. `nairas` uses hourly NAIRAS effective-dose zarr datasets stored in S3 and samples generated route waypoints from the route date at 00:00 UTC. Lookup uses linear interpolation in altitude, latitude, and longitude, with nearest-neighbour fallback when interpolation returns a non-finite value. The route `duration` parameter controls route integration, not NAIRAS dataset-hour selection.\n","in":"query","name":"model","required":false,"schema":{"default":"cari7","enum":["cari7","nairas"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"dose":{"date":"21/05/2019","destination":"33.94250107,-118.4079971","is_prediction":false,"is_sep":false,"model":"cari7","origin":"YSSY","units":"uSv","value":9.90406659800017}},"properties":{"dose":{"properties":{"date":{"description":"Date of calculation in DD/MM/YYYY.","type":"string"},"destination":{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination (echoing format sent in request).","type":"string"},"is_prediction":{"description":"Whether the calculation is based on predicted heliocentric potentials.","type":"boolean"},"is_sep":{"description":"Whether any sampled route point uses data flagged as a solar energetic particle event.","type":"boolean"},"model":{"enum":["cari7","nairas"],"type":"string"},"origin":{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the airport (echoing format sent in request).","type":"string"},"units":{"description":"Units of the radiation dose.","type":"string"},"value":{"description":"Radiation dose value.","type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful dose calculation"}},"summary":"Calculate effective dose along a great circle flight route.","tags":["route"],"x-codeSamples":[{"label":"Curl: Constant altitude","lang":"Curl","source":"curl -X GET \"https://avrad.amentum.io/route?origin=YSSY&destination=33.94250107,-118.4079971&altitude=10.1&duration=5&year=2019&month=5&day=21&model=cari7\"  -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"},{"label":"Curl: Step climb","lang":"Curl","source":"curl -X GET \"https://avrad.amentum.io/route?origin=YSSY&destination=LAX&year=2023&month=10&day=12&initial_altitude=0.0&final_altitude=0.0&descent_time=0.07126&climb_times=0.05&climb_times=0.18333334&climb_times=0.05&climb_times=0.01922&cruising_times=0.0&cruising_times=4.123&cruising_times=2.0&cruising_times=0.0&cruising_altitudes=2.1893&cruising_altitudes=8.5432&cruising_altitudes=11.1826&cruising_altitudes=0.3628\" -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}},"/route/effective_dose":{"get":{"deprecated":true,"description":"Deprecated compatibility endpoint for released clients. This endpoint uses the default CARI-7 model. Use GET /route for new integrations.\n","operationId":"app.api_route.endpoints.Route.effective_dose","parameters":[{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the origin airport.","in":"query","name":"origin","required":true,"schema":{"example":"YSSY","type":"string"}},{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination airport.","in":"query","name":"destination","required":true,"schema":{"example":"33.94250107,-118.4079971","type":"string"}},{"description":"Altitude (in km). The minimum is 0 m, the maximum is 20 km.","in":"query","name":"altitude","required":false,"schema":{"example":10.1,"type":"number"}},{"description":"The flight duration in hours. The minimum is 0, the maximum is 20 hrs.","in":"query","name":"duration","required":false,"schema":{"example":5,"type":"number"}},{"description":"Initial altitude (in km) for a step climb. The minimum is 0 m, the maximum is 20 km.","in":"query","name":"initial_altitude","required":false,"schema":{"example":0.0,"type":"number"}},{"description":"Cruising altitudes (in km) for a step climb. The minimum is 0 m, the maximum is 20 km.","in":"query","name":"cruising_altitudes","required":false,"schema":{"example":[10.0,10.5,11.0],"items":{"type":"number"},"type":"array"}},{"description":"Climb times for each cruising altitude (in hours) for a step climb.","in":"query","name":"climb_times","required":false,"schema":{"example":[0.1,0.5,0.4],"items":{"type":"number"},"type":"array"}},{"description":"Cruising times at each cruising altitude (in hours) for a step climb.","in":"query","name":"cruising_times","required":false,"schema":{"example":[1.0,2.0,3.0],"items":{"type":"number"},"type":"array"}},{"description":"Descent time from last cruising altitude to final altitude (in hours) for a step climb.","in":"query","name":"descent_time","required":false,"schema":{"example":0.5,"type":"number"}},{"description":"Final altitude (in km) for a step climb.","in":"query","name":"final_altitude","required":false,"schema":{"example":0.0,"type":"number"}},{"description":"Year in YYYY.","in":"query","name":"year","required":true,"schema":{"example":2019,"type":"integer"}},{"description":"Month in MM.","in":"query","name":"month","required":true,"schema":{"example":5,"type":"integer"}},{"description":"Day in DD.","in":"query","name":"day","required":true,"schema":{"example":21,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"example":{"dose":{"date":"21/05/2019","destination":"33.94250107,-118.4079971","is_prediction":false,"is_sep":false,"model":"cari7","origin":"YSSY","units":"uSv","value":9.90406659800017}},"properties":{"dose":{"properties":{"date":{"description":"Date of calculation in DD/MM/YYYY.","type":"string"},"destination":{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination (echoing format sent in request).","type":"string"},"is_prediction":{"description":"Whether the calculation is based on predicted heliocentric potentials.","type":"boolean"},"is_sep":{"description":"Whether any sampled route point uses data flagged as a solar energetic particle event.","type":"boolean"},"model":{"enum":["cari7","nairas"],"type":"string"},"origin":{"description":"The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the airport (echoing format sent in request).","type":"string"},"units":{"description":"Units of the radiation dose.","type":"string"},"value":{"description":"Radiation dose value.","type":"number"}},"type":"object"}},"type":"object"}}},"description":"Successful dose calculation"}},"summary":"Deprecated. Use GET /route.","tags":["route"],"x-codeSamples":[{"label":"Curl: Constant altitude","lang":"Curl","source":"curl -X GET \"https://avrad.amentum.io/route/effective_dose?origin=YSSY&destination=33.94250107,-118.4079971&altitude=10.1&duration=5&year=2019&month=5&day=21\"  -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"},{"label":"Curl: Step climb","lang":"Curl","source":"curl -X GET \"https://avrad.amentum.io/route/effective_dose?origin=YSSY&destination=LAX&year=2023&month=10&day=12&initial_altitude=0.0&final_altitude=0.0&descent_time=0.07126&climb_times=0.05&climb_times=0.18333334&climb_times=0.05&climb_times=0.01922&cruising_times=0.0&cruising_times=4.123&cruising_times=2.0&cruising_times=0.0&cruising_altitudes=2.1893&cruising_altitudes=8.5432&cruising_altitudes=11.1826&cruising_altitudes=0.3628\" -H \"accept: application/json\" -H \"API-Key: <your_key>\"\n"}]}}},"servers":[{"url":""}],"tags":[{"description":"","name":"flighttrack","x-displayName":"Flight Track"},{"description":"","name":"route","x-displayName":"Route"},{"description":"","name":"point","x-displayName":"Point"}],"x-tagGroups":[{"name":"Calculate radiation dose along a planned flight route","tags":["route"]},{"name":"Calculate radiation dose along ADS-B recorded flight-track waypoints","tags":["flighttrack"]},{"name":"Calculate radiation dose at a point","tags":["point"]}]}