ISIC Archive REST API Documentation

Thank you for visiting the ISIC Archive API! A summary of how to accomplish the most common tasks is provided here:

Retrieving a List of Images

Use the /image endpoint.

Retrieving a List of Current Studies

Use the /study endpoint.

Retrieving Image Metadata

Use the /image/{id} endpoint, with the "_id" value from the data provided by the /image endpoint. Data can be returned for only one image at a time.

Download an Image

Use the /image/{id}/download endpoint, with the "_id" value from the data provided by the /image endpoint. Data can be returned for only one image at a time.

Download Image Superpixel Data

Use the /image/{id}/superpixels endpoint, with the "_id" value from the data provided by the /image endpoint. Data can be returned for only one image at a time.

Download a Segmentation Mask

Use the /segmentation endpoint, with the "_id" value from the data provided by the /image endpoint. In the data returned, retrieve the "_id" value for the desired segmentation mask, and use that value with the /segmentation/{id}/mask endpoint. Data can be returned for only one mask at a time.

Download an Annotation Mask

Use the /study endpoint to get a list of studies. For the desired study, use the "_id" variable with the /annotation endpoint to get a list of annotations for that given study. From the list of annotations, select the "_id" (annotationId) variable of the desired annotation and use the /annotation/{annotationId} endpoint to get a list of feature markups for that annotation. You can then use the annotationId and the feature name with the /annotation/{annotationId}/markup/{featureId} endpoint to download a markup mask. Data can be returned for only one mask at a time.