APIHub
Back to Explore

Aviation Radiation API

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.

Geocoding
none
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

518ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/cari7/ambient_dose

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"

amentum.space · HTTPS only