The Aviation Radiation API computes ambient dose equivalent and effective dose rates from solar and galactic cosmic radiation for a specified location, altitude (or atmospheric depth), date, time, and particle type, and can also estimate these doses along a defined flight route using origin, destination and flight profile parameters.
The ambient dose equivalent rate calculated for a single particle type, or accumulated over all particle types.
altitude(query, required) — Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).
latitude(query, required) — Latitude. -90 (S) to 90 (N).
longitude(query, required) — Longitude. -180 (W) to 180 (E).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
utc(query, required) — Hour in 24 hour time.
particle(query, required) — The particle type as a string. Specifying 'total' returns the dose for all particle types.
GET
/cari7/effective_dose
The effective dose rate calculated for a single particle type, or accumulated over all particle types.
altitude(query, required) — Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).
latitude(query, required) — Latitude. -90 (S) to 90 (N).
longitude(query, required) — Longitude. -180 (W) to 180 (E).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
utc(query, required) — Hour in 24 hour time.
particle(query, required) — The particle type as a string. Specifying 'total' returns the dose for all particle types.
GET
/parma/ambient_dose
The ambient dose equivalent rate calculated for a single particle type, or accumulated over all particle types.
altitude(query) — Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).
atmospheric_depth(query) — Atmospheric depth from the top of the atmosphere (in units of g/cm2). The minimum is 0.913 g/cm2, the maximum is 1032.66 g/cm2. WARNING: you can specify either altitude OR atmospheric depth, not both.
latitude(query, required) — Latitude. -90 (S) to 90 (N).
longitude(query, required) — Longitude. -180 (W) to 180 (E).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
particle(query, required) — The particle type as a string. Specifying 'total', only used for the dose calculation, returns the dose for all particle types.
GET
/parma/differential_intensity
The energy differential intensity of a particle at a given zenith angle.
altitude(query) — Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).
atmospheric_depth(query) — Atmospheric depth from the top of the atmosphere (in units of g/cm2). The minimum is 0.913 g/cm2, the maximum is 1032.66 g/cm2. WARNING: you can specify either altitude OR atmospheric depth, not both.
latitude(query, required) — Latitude. -90 (S) to 90 (N).
longitude(query, required) — Longitude. -180 (W) to 180 (E).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
particle(query, required) — The particle type as a string. Specifying 'total', only used for the dose calculation, returns the dose for all particle types.
angle(query, required) — Direction cosine. 1.0 is in the downward direction.
GET
/parma/effective_dose
The effective dose rate calculated for a single particle type, or accumulated over all particle types.
altitude(query) — Altitude (in km). The minimum is 0 m, the maximum is 47 km (the upper limit of the stratosphere).
atmospheric_depth(query) — Atmospheric depth from the top of the atmosphere (in units of g/cm2). The minimum is 0.913 g/cm2, the maximum is 1032.66 g/cm2. WARNING: you can specify either altitude OR atmospheric depth, not both.
latitude(query, required) — Latitude. -90 (S) to 90 (N).
longitude(query, required) — Longitude. -180 (W) to 180 (E).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
particle(query, required) — The particle type as a string. Specifying 'total', only used for the dose calculation, returns the dose for all particle types.
GET
/route/ambient_dose
Calculate the ambient equivalent dose along a great circle flight route.
origin(query, required) — The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the origin airport.
destination(query, required) — The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination airport.
altitude(query) — Altitude (in km). The minimum is 0 m, the maximum is 20 km.
duration(query) — The flight duration in hours. The minimum is 0, the maximum is 20 hrs.
initial_altitude(query) — Initial altitude (in km). The minimum is 0 m, the maximum is 20 km.
cruising_altitudes(query) — Cruising altitudes (in km). The minimum is 0 m, the maximum is 20 km.
climb_times(query) — Climb times for each cruising altitude (hours).
cruising_times(query) — Cruising times at each cruising altitude (hours).
descent_time(query) — Descent time from last cruising altitude to final altitude (hours).
final_altitude(query) — Final altitude (in km).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
GET
/route/effective_dose
Calculate the total effective dose along a great circle flight route.
origin(query, required) — The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the origin airport.
destination(query, required) — The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination airport.
altitude(query) — Altitude (in km). The minimum is 0 m, the maximum is 20 km.
duration(query) — The flight duration in hours. The minimum is 0, the maximum is 20 hrs.
initial_altitude(query) — Initial altitude (in km). The minimum is 0 m, the maximum is 20 km.
cruising_altitudes(query) — Cruising altitudes (in km). The minimum is 0 m, the maximum is 20 km.
climb_times(query) — Climb times for each cruising altitude (hours).
cruising_times(query) — Cruising times at each cruising altitude (hours).
descent_time(query) — Descent time from last cruising altitude to final altitude (hours).
final_altitude(query) — Final altitude (in km).
year(query, required) — Year in YYYY.
month(query, required) — Month in MM.
day(query, required) — Day in DD.
7 endpoints auto-detected
curl -X GET \
"https://amentum.space/cari7/ambient_dose"