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"

{
  "cdn_url": "https://ucarecdn.com/badfc9f7-f88f-4921-9cc0-22e2c08aa2da/",
  "datetime_created": "2024-01-15T09:30:00Z",
  "files": [
    {
      "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,
          "datetime_original": "2024-01-14T15:20:00Z",
          "dpi": [
            72,
            72
          ],
          "sequence": false
        }
      }
    }
  ],
  "files_count": 12,
  "id": "badfc9f7-f88f-4921-9cc0-22e2c08aa2da~12",
  "url": "https://api.uploadcare.com/groups/badfc9f7-f88f-4921-9cc0-22e2c08aa2da~12/"
}

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

cdn_urlstringformat: "uri"

Group's CDN URL.

datetime_createddatetime

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

fileslist of any or null

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

files_countinteger>=1

Number of the files in the group.

idstring

Group's identifier.

urlstringformat: "uri"

Group's API resource URL.

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