---
title: "Calculate the ambient equivalent dose along a great circle flight route."
method: GET
path: "/route/ambient_dose"
tags: ["routedose"]
---

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

`GET /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.  <br> <br> Use this endpoint if you are comparing model predictions to measurements. <br> <br> This API can run in two modes: <br> <br> Either specify <br> <b>altitude</b>, <b>duration</b><br> for constant altitude calculations; <br> <br> Or specify <br> <b>initial_altitude</b>, <b>cruising_altitudes</b>, <b>climb_times</b>, <b>cruising_times</b>, <b>descent_time</b>, <b>final_altitude</b><br> to calculate dose accounting for a step climb. <br> <br> 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.

## Query parameters

- `origin` string, required
- `destination` string, required
- `altitude` number
- `duration` number
- `initial_altitude` number
- `cruising_altitudes` number[]
- `climb_times` number[]
- `cruising_times` number[]
- `descent_time` number
- `final_altitude` number
- `year` integer, required
- `month` integer, required
- `day` integer, required

## Response `200`

Successful dose calculation

- object
  - `dose` object
    - `date` string
    - `destination` string
    - `origin` string
    - `units` string
    - `value` number

---

[API](https://skmtc.net/amentum/apis/aviation-radiation.md) · [All operations](https://skmtc.net/amentum/apis/aviation-radiation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amentum/aviation-radiation/versions/3ccdfd4584ac/schema)