Livechart Data Download API
This API allows the direct download of data. At the moment the format provided is CSV (comma separated values). Future developments will include more formats, and more options to build custom queries.

Examples
The service URL is nds.iaea.org/relnsd/v1/data? followed by request parameters.
(please note that using 'v0' is the same as using 'v1' )
Here some examples of data request parameters:
fields=levels&nuclides=135xe    try it »
Xe-135 levels
fields=gammas&nuclides=135xe    try it »
Xe-135 gamma transitions
fields=ground_states&nuclides=all    try it »
all ground states in the database
fields=cumulative_fy&parents=233u    try it »
U-233 cumulative fission yields
fields=cumulative_fy&products=135xe    try it »
cumulative fission yields producing Xe-135
fields=decay_rads&nuclides=135xe&rad_types=e    try it »
electrons (Auger and conversion) from Xe-135 decays

Attention
Jupyter lab
The Livechart API works very effectively with Python data analysis libraries (pandas and plotly in these examples), the first step to build models for Machine Learning.
Many examples, including 3D plotting, are detailed in this Notebook

Attention
There have been cases in which the service returns an HTTP Error 403: Forbidden
The workaround is to add an user agent to the request.
In Python:
def lc_read_csv(url):
    req = urllib.request.Request(url)
    req.add_header('User-Agent', 
        'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:77.0) Gecko/20100101 Firefox/77.0')
    content = urllib.request.urlopen(req)
    return content

in Java:
protected String lc_read_csv(url){

    URL murl = new URL(url);
    URLConnection conn = murl.openConnection();
    conn.setRequestProperty("User-Agent",
    "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:77.0) Gecko/20100101 Firefox/77.0");
       
    BufferedReader br = new BufferedReader(
                   new InputStreamReader(conn.getInputStream()));

    String inputLine;
    StringBuffer sb = new StringBuffer();
    while ((inputLine = br.readLine()) != null) {
        sb.append(inputLine);
    }
    br.close();
    return sb.toString();
  }

For other languages, add the suggested user agent to the request using the avaliable function
API description
Service URL
The URL of the service is nds.iaea.org/relnsd/v1/data? followed by a chain of parameters linked by &. A parameter is specified as name=value

Parameters

fields

mandatory

Specifies which fields are fetched. At the moment, a predefined group of fields is avaliable. Further development will allow the user to specify the list of fields.

Values
ground_states or levels or gammas or decay_rads or cumulative_fy or independent_fy

Example
fields=cumulative_fy

See below for the description of the fields included in each group.

nuclides

Is mandatory for ground_states, levels, gammas, and decay_rads
It has no effect on cumulative_fy or independent_fy

Restricts the retrieval to the specified nuclide
In this version of the API, only one nuclide can be specified

Values
nuclides=135xe (mass+element)
or
nuclides=all allowed only for ground_states. All ground states are returned

parents

Valid only for cumulative_fy and independent_fy

All the products for the specified parent are returned.
In this API version only one parent can be specified

Values
parents= 232th or 233u or 235u or 238u or 237np or 239pu or 241pu or 241am


products

Valid only for cumulative_fy and independent_fy

All the fission yields of this product, for any parent, are returned
In this API version only one product can be specified

Values
products=135xe (mass+element)


rad_types

Only for, and mandatory for, decay_rads
Only one value is allowed

Data are returned only for the specified type of radiation
In this API version only one radiation can be present

Values
a bp bm g e x (α, β-, β+ and electron capture, γ, Auger and conversion electron, X-ray)

Full Example
fields=decay_rads&nuclides=135xe&rad_types=e

Fields content
Data sources
In the following
Field groups
ENSDF_publication_cut-off, ENSDF_authors, and extraction date are at the end of each row
ground_states
Properties on the nuclide and its ground state level
levels
Properties of the excited energy levels of a nuclide
The meaning and source of the fields are the same as the ground_state set. Additional fields are:
gammas
Properties of the electromagnetic transitions between energy levels of the nuclide
In the following :
decay_rads
Properties of the radiations emitted by the daughter(s) of the nuclide that decays
In the following : Fields common to all decay radiation types



α radiations

• X-ray, electrons



• β radiations



• γ radiations



• β radiations



Error codes

When no data are retrieved, a numeric code is returned



Feedback
Please address any feedback to NDS contact point

IAEA - Nuclear Data Section
Vienna International Centre, PO Box 100
A-1400 Vienna, Austria
Telephone: (+431) 2600-0
email:nds.contact-point
© 2009- IAEA Nuclear Data Section   
Terms of use