---
title: "Calculate the total effective dose along a great circle flight route."
method: GET
path: "/route/effective_dose"
tags: ["routedose"]
---

# Calculate the total effective dose along a great circle flight route.

`GET /route/effective_dose`

Effective Dose is a radiation protection quantity defined by the International Commission on
 Radiological Protection (ICRP) and represents the stochastic health
 risk to the human body at low levels of radiation.
It accounts for the different sensitivities of organs to ionising radiation, as well as the different effectiveness of various types of radiation. <br> <br> Use this endpoint if you need to estimate radiation exposures of personnel. <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)