get route ambient dose - aviation-radiation API | Specway Docs

GET

Calculate the ambient equivalent dose along a great circle flight route.

https://amentum.space/route/ambient_dose

The ambient dose equivalent, H*(10), is an operational quantity that simulates the human body by measuring the dose equivalent at a depth of 10 mm within a tissue equivalent sphere of 300 mm diameter. It is a measurable quantity that is used to calibrate area monitors (radiation detectors) for mixed radiation fields. Use this endpoint if you are comparing model predictions to measurements. This API can run in two modes: Either specify altitude, duration for constant altitude calculations; Or specify initial_altitude, cruising_altitudes, climb_times, cruising_times, descent_time, final_altitude to calculate dose accounting for a step climb. Note: the airport codes or coordinates (depending on which was specified), and the date in DD/MM/YYYY format, are echoed in the json response as strings.

Access Token Required: API Key

Query Params

originstringrequired

The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the origin airport.

destinationstringrequired

The ICAO code or IATA code or latitude,longitude pair (in decimal degrees) of the destination airport.

altitudenumber

Altitude (in km). The minimum is 0 m, the maximum is 20 km.

durationnumber

The flight duration in hours. The minimum is 0, the maximum is 20 hrs.

initial_altitudenumber

Initial altitude (in km). The minimum is 0 m, the maximum is 20 km.

cruising_altitudesarray

Cruising altitudes (in km). The minimum is 0 m, the maximum is 20 km.

climb_timesarray

Climb times for each cruising altitude (hours).

cruising_timesarray

Cruising times at each cruising altitude (hours).

descent_timenumber

Descent time from last cruising altitude to final altitude (hours).

final_altitudenumber

Final altitude (in km).

yearintegerrequired

Year in YYYY.

monthintegerrequired

Month in MM.

dayintegerrequired

Day in DD.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://amentum.space/route/ambient_dose' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET