Check the status of a task to fetch/upload a file from a URL

GET

https://upload.uploadcare.com/from_url/status/

GET

/from_url/status/

curl -G https://upload.uploadcare.com/from_url/status/ \
     -d token=945ebb27-1fd6-46c6-a859-b9893712d650

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

The endpoint notifies about the progress of the task by changing the value of the status field:

the field is set to waiting initially
once the system starts processing the request, the field is set to progress
if the file is fetched and uploaded successfully, the status field is set to success and the endpoint returns a JSON object holding information about the uploaded file
if the system fails to fetch/upload the file, the status field is set to error and the error field is set to the cause of the error.

Query parameters

tokenstringRequiredformat: "uuid"

Token returned by the /from_url/ endpoint that identifies a request to fetch/upload a file from a URL.

Response

Request was processed successfully.

fileUploadInfoSuccessStatusobject

fileUploadInfoWaitingStatusobject

fileUploadInfoProgressStatusobject

fileUploadInfoErrorStatusobject

fileUploadInfoUnknownStatusobject