GlycoData REST API

This document describes the usage of the GlycoData REST API built with Django REST framework. All endpoints are rooted at https://glycodata.org.

1. API Root (GDD)

The GDD API Root is the entry point for all GlycoData “gdd” resources. It returns a JSON object mapping each available resource to its URL.

Request

GET /api/gdd/

2. Available GDD Resources

Resource	Endpoint	Methods	Description
Solubilities	/api/gdd/solubilities/	GET	Retrieve a paginated list of solubility measurements.
Viscosities	/api/gdd/viscosities/	GET	Retrieve a paginated list of viscosity measurements.
Activation Energies	/api/gdd/activation-energies/	GET	Retrieve activation energy values for various processes.
Diffusion Constants (Table 1)	/api/gdd/diffusion-constants-table1/	GET	Retrieve diffusion constants (first dataset).
Hygroscopicity	/api/gdd/hygroscopicity/	GET	Retrieve hygroscopicity data.
Diffusion Constants (Table 2)	/api/gdd/diffusion-constant-table2/	GET	Retrieve diffusion constants (second dataset).
Optical Rotations	/api/gdd/optical-rotations/	GET	Retrieve optical rotation measurements.
Glass Transition Temperatures	/api/gdd/glass-transition-temperatures/	GET	Retrieve glass transition temperature data.
IR Spectra	/api/gdd/ir-spectra/	GET	Retrieve infrared spectra data.

3. Chronicle List (Chronicles)

The /api/chronicles/ endpoint provides list and retrieve actions for chronicles, exposing only selected fields: PID, title, author, affiliation, description, and img_url.

List Request

GET /api/chronicles/

Retrieve Request

GET /api/chronicles/<PID>/
/* e.g. GET /api/chronicles/GLDP000001/ */

4. Filters & Pagination

?page=<n> — Page navigation. Each page will show maximum 20 results

For example, to retrieve the second page:

GET https://glycodata.org/api/chronicles/?page=2

5. Usage Examples

5.1 GDD Endpoints

Fetch the API root for all GDD resources, or fetch a specific list:

# GDD API Root
curl -X GET "https://glycodata.org/api/gdd/" \
     -H "Accept: application/json"

# Solubilities list
curl -X GET "https://glycodata.org/api/gdd/solubilities/" \
     -H "Accept: application/json"

5.2 Chronicles

Fetch the list of chronicles, or retrieve one by its PID:

# List all chronicles
curl -X GET "https://glycodata.org/api/chronicles/" \
     -H "Accept: application/json"

# Retrieve a single chronicle by PID
curl -X GET "https://glycodata.org/api/chronicles/GLDP000001/" \
     -H "Accept: application/json"

Documentation generated on July 17, 2025.