Group info | Uploadcare docs

curl https://api.uploadcare.com/groups/badfc9f7-f88f-4921-9cc0-22e2c08aa2da~12/ \
     -H "Accept: application/vnd.uploadcare-v0.7+json" \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "id": "badfc9f7-f88f-4921-9cc0-22e2c08aa2da~12",
  "datetime_created": "2024-01-15T09:30:00Z",
  "files_count": 12,
  "cdn_url": "https://ucarecdn.com/badfc9f7-f88f-4921-9cc0-22e2c08aa2da/",
  "url": "https://api.uploadcare.com/groups/badfc9f7-f88f-4921-9cc0-22e2c08aa2da~12/",
  "files": [
    {
      "datetime_removed": null,
      "datetime_stored": "2024-01-15T10:00:00Z",
      "datetime_uploaded": "2024-01-15T09:45:00Z",
      "is_image": true,
      "is_ready": true,
      "mime_type": "image/jpeg",
      "original_file_url": "https://ucarecdn.com/e575ed4e8-f4e8-4c14-a58b-1527b6d9ee46/EU_4.jpg",
      "original_filename": "EU_4.jpg",
      "size": 145212,
      "url": "https://api.uploadcare.com/files/e575ed4e8-f4e8-4c14-a58b-1527b6d9ee46/",
      "uuid": "e575ed4e8-f4e8-4c14-a58b-1527b6d9ee46",
      "variations": {},
      "content_info": {
        "mime": {
          "mime": "image/jpeg",
          "type": "image",
          "subtype": "jpeg"
        },
        "image": {
          "color_mode": "RGBA",
          "orientation": 1,
          "format": "JPEG",
          "height": 2352,
          "width": 2935,
          "geo_location": null,
          "datetime_original": "2024-01-14T15:20:00Z",
          "dpi": [
            72,
            72
          ],
          "sequence": false
        },
        "video": null
      },
      "metadata": null,
      "appdata": null
    }
  ]
}

Get a file group by its ID.

Groups are identified in a way similar to individual files. A group ID consists of a UUID followed by a “~” (tilde) character and a group size: integer number of the files in the group.

Authentication

Authorizationstring

Every request made to https://api.uploadcare.com/ MUST be signed. HTTPS SHOULD be used with any authorization scheme.

Requests MUST contain the Authorization header defining auth-scheme and auth-param: Authorization: auth-scheme auth-param.

Every request MUST contain the Accept header identifying the REST API version: Accept: application/vnd.uploadcare-v0.7+json.

There are two available authorization schemes:

For production: Uploadcare, a scheme where a signature, not your Secret API Key MUST be specified. Signatures SHOULD be generated on backend.
For quick tests: Uploadcare.Simple, a simple scheme where your Secret API Key MUST be specified in every request’s auth-param.

Every request made to `https://api.uploadcare.com/` MUST be signed. HTTPS SHOULD be used with any authorization scheme. Requests MUST contain the `Authorization` header defining `auth-scheme` and `auth-param`: `Authorization: auth-scheme auth-param`. Every request MUST contain the `Accept` header identifying the REST API version: `Accept: application/vnd.uploadcare-v0.7+json`. There are two available authorization schemes: * For production: `Uploadcare`, a scheme where a `signature`, not your Secret API Key MUST be specified. Signatures SHOULD be generated on backend. * For quick tests: `Uploadcare.Simple`, a simple scheme where your [Secret API Key](https://app.uploadcare.com/projects/-/api-keys/) MUST be specified in every request's `auth-param`.

Path parameters

uuidstringRequired

Group UUID.

Response

Group's info

idstring

Group's identifier.

datetime_createddatetime

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

files_countinteger>=1

Number of the files in the group.

cdn_urlstringformat: "uri"

Group's CDN URL.

urlstringformat: "uri"

Group's API resource URL.

fileslist of any or null

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

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

Authentication

Path parameters

Headers

Response

Errors