Get information about a file group

curl -G https://upload.uploadcare.com/group/info/ \
     -H "Content-Type: application/json" \
     -d pub_key=caa9d29da887ee88ffe6 \
     -d group_id=0d712319-b970-4602-850c-bae1ced521a6~1

{
  "id": "0d712319-b970-4602-850c-bae1ced521a6~1",
  "datetime_created": "2018-09-12T10:03:38.686710Z",
  "files_count": 1,
  "cdn_url": "https://ucarecdn.com/0d712319-b970-4602-850c-bae1ced521a6~1/",
  "url": "https://api.uploadcare.com/groups/0d712319-b970-4602-850c-bae1ced521a6~1/",
  "files": [
    {
      "uuid": "575ed4e8-f4e8-4c14-a58b-1527b6d9ee46",
      "file_id": "575ed4e8-f4e8-4c14-a58b-1527b6d9ee46",
      "size": 145212,
      "total": 145212,
      "done": 145212,
      "original_filename": "test-image_1.jpg",
      "filename": "testimage_1.jpg",
      "mime_type": "image/jpeg",
      "image_info": {
        "width": 1920,
        "height": 1080,
        "format": "jpeg",
        "color_mode": "RGB",
        "orientation": 1,
        "dpi": [
          72,
          72
        ],
        "frames": 1
      },
      "content_info": {
        "size": 145212,
        "mime_type": "image/jpeg"
      },
      "metadata": {
        "uploaded": "2018-09-12T10:03:38.686710Z",
        "source": "api"
      },
      "is_image": true,
      "is_stored": true,
      "is_ready": true,
      "default_effects": "resize/x800/"
    }
  ]
}

Returns a JSON object with information about a file group (when the group was created, number of the files in the group, etc).

Query parameters

pub_keystringRequired

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

group_idstringRequired

Group’s unique ID. Group IDs look like UUID~N, where the ~N part reflects the number of the files in the group.

Response

File group information was retrieved successfully.

idstring

Group's unique ID.

datetime_createddatetime

ISO-8601 date and time when the group was created.

files_countinteger

Number of the files in the group.

cdn_urlstringformat: "uri"

Group's CDN URL.

urlstringformat: "uri"

Group’s API resource URL. See the REST API documentation for details.

fileslist of any or null

The list of files in the group. An array may contain null values if a file has been removed.

datetime_storeddatetime or nullDeprecated

Deprecated. This field will be removed in a future version of the Upload API.