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.