Get information about an uploaded file

curl -G https://upload.uploadcare.com/info/ \
     -d pub_key=YOUR_PUBLIC_KEY \
     -d file_id=67947755-1584-4e3f-902b-d4e2bf76a841

{
  "uuid": "be3b4d5e-179d-460e-8a5d-69112ac86cbb",
  "file_id": "be3b4d5e-179d-460e-8a5d-69112ac86cbb",
  "size": 2667636,
  "total": 2667636,
  "done": 2667636,
  "original_filename": "IMG-0412_123.JPG",
  "filename": "IMG0412_123.JPG",
  "mime_type": "image/jpeg",
  "image_info": {
    "color_mode": "RGB",
    "orientation": 6,
    "format": "JPEG",
    "sequence": false,
    "height": 4032,
    "width": 3024,
    "geo_location": {
      "latitude": 55.62013611111111,
      "longitude": 37.66299166666666
    },
    "datetime_original": "2018-08-20T08:59:50",
    "dpi": [
      72,
      72
    ]
  },
  "video_info": null,
  "content_info": {
    "mime": {
      "mime": "image/jpeg",
      "type": "image",
      "subtype": "jpeg"
    },
    "image": {
      "color_mode": "RGB",
      "orientation": 6,
      "format": "JPEG",
      "sequence": false,
      "height": 4032,
      "width": 3024,
      "geo_location": {
        "latitude": 55.62013611111111,
        "longitude": 37.66299166666666
      },
      "datetime_original": "2018-08-20T08:59:50",
      "dpi": [
        72,
        72
      ]
    }
  },
  "metadata": {
    "subsystem": "uploader",
    "pet": "cat"
  },
  "is_image": true,
  "is_stored": true,
  "is_ready": true
}

Returns a JSON object with information about an uploaded file (file size, MIME type, metadata, etc).

Query parameters

pub_keystringRequired

Public key identifying an Uploadcare project your uploads will go to.

file_idstringRequiredformat: "uuid"

File's unique ID.

Response

File information was retrieved successfully.

uuidstringformat: "uuid"

File's unique ID.

file_idstringformat: "uuid"

Same as uuid

sizeinteger

File's size in bytes.

totalinteger

Same as size.

doneinteger

Same as size.

original_filenamestring

Original file of the uploaded file.

filenamestring

Sanitized original_filename.

mime_typestring

File’s MIME-type.

image_infoobject

Image metadata.

video_infoobject

Video metadata.

content_infoobject

Information about file content.

metadataobject

Arbitrary metadata associated with a file.

is_imageboolean

True if the uploaded file is an image of a supported file format.

is_storedboolean

True if the file has been marked as stored.

is_readyboolean

True if the file is ready to be fetched from Uploadcare's CDN.

s3_bucketstring or null

Name of an AWS S3 bucket where the file is stored. Only available if you associate a Foreign Storage Bucket with your project.