List of groups | Uploadcare docs

curl -G https://api.uploadcare.com/groups/ \
     -H "Accept: application/vnd.uploadcare-v0.7+json" \
     -H "Authorization: <apiKey>" \
     --data-urlencode from=2015-01-02T10:00:00.463352Z \
     -d limit=150 \
     -d ordering=-datetime_created

{
  "next": "https://api.uploadcare.com/groups/?limit=3&from=2016-11-09T14%3A30%3A22.421889%2B00%3A00&offset=0",
  "previous": null,
  "total": 100,
  "per_page": 2,
  "results": [
    {
      "id": "dd43982b-5447-44b2-86f6-1c3b52afa0ff~1",
      "datetime_created": "2018-11-27T14:14:37.583654Z",
      "files_count": 1,
      "cdn_url": "https://ucarecdn.com/dd43982b-5447-44b2-86f6-1c3b52afa0ff~1/",
      "url": "https://api.uploadcare.com/groups/dd43982b-5447-44b2-86f6-1c3b52afa0ff~1/"
    },
    {
      "id": "fd59dbcb-40a1-4f3a-8062-cc7d23f66885~1",
      "datetime_created": "2018-11-27T15:14:39.586674Z",
      "files_count": 1,
      "cdn_url": "https://ucarecdn.com/fd59dbcb-40a1-4f3a-8062-cc7d23f66885~1/",
      "url": "https://api.uploadcare.com/groups/fd59dbcb-40a1-4f3a-8062-cc7d23f66885~1/"
    }
  ]
}

Get a paginated list of groups.

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.

Query parameters

limitintegerOptional

A preferred amount of groups in a list for a single response. Defaults to 100, while the maximum is 1000.

fromdatetimeOptional

A starting point for filtering the list of groups. If passed, MUST be a date and time value in ISO-8601 format.

orderingenumOptionalDefaults to datetime_created

Specifies the way groups should be sorted in the returned list. datetime_created for the ascending order (default), -datetime_created for the descending one.

Allowed values:

Response

A list of groups, paginated.

nextstring or nullOptionalformat: "uri"

Next page URL.

previousstring or nullOptionalformat: "uri"

Previous page URL.

totalintegerOptional>=0

Total number of groups in the project.

per_pageintegerOptional

Number of groups per page.

resultslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

406

Not Acceptable Error

429

Too Many Requests Error

Authentication

Headers

Query parameters

Response

Errors