File info as JSON

GET
Returns file-related information, such as image dimensions or geo tagging data in the JSON format.

Path parameters

uuidstringRequired
Unique file identifier

Response

This endpoint returns an object.
idstring
File UUID.
dpilist of doublesOptional
Image DPI for two dimensions.
widthintegerOptional
Image width in pixels.
formatstringOptional
Image format.
heightintegerOptional
Image height in pixels.
sequencebooleanOptional
Set to true if a file contains a sequence of images (GIF for example).
color_modeenumOptional
Image color mode.
orientationintegerOptional
Image orientation from EXIF.
geo_locationobjectOptional
Geo-location of image from EXIF.
datetime_originaldatetimeOptional
Image date and time from EXIF. Please be aware that this data is not always formatted and displayed exactly as it appears in the EXIF.
hashstringOptional

File info response includes a value of a perceptual hash calculated using pixel contents of an image. Perceptual hashing is a common fingerprinting technique to quickly compare images and find duplicates or similar images. Uploadcare automatically calculates a 64-bit long perceptual hash value and returns it as a HEX string. It’s easy to find image duplicates by quickly comparing their perceptual hash values. To find similar images, it’s important to compare perceptual hash values bitwise (Hamming distance). A small number of unmatched bits (e.g., up to 8 bits) will correspond to subtle changes in the visual contents, while non-similar images will usually have more than 8 different bits.

Errors