List stored files

GET

https://api.mailchimp.com/3.0/file-manager/folders/:folder_id/files

GET

/3.0/file-manager/folders/:folder_id/files

curl https://api.mailchimp.com/3.0/file-manager/folders/folder_id/files \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "_links": [
    {
      "href": "string",
      "method": "GET",
      "rel": "string",
      "schema": "string",
      "targetSchema": "string"
    }
  ],
  "files": [
    {
      "_links": [
        {
          "href": "string",
          "method": "GET",
          "rel": "string",
          "schema": "string",
          "targetSchema": "string"
        }
      ],
      "created_at": "2024-01-15T09:30:00Z",
      "created_by": "string",
      "folder_id": 1,
      "full_size_url": "string",
      "height": 1,
      "id": 1,
      "name": "string",
      "size": 1,
      "thumbnail_url": "string",
      "type": "image",
      "width": 1
    }
  ],
  "total_file_size": 1.1,
  "total_items": 1
}

Get a list of available images and files stored in this folder.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

AuthorizationBearer

Authorization using OAuth

Path parameters

folder_idstringRequired

The unique id for the File Manager folder.

Query parameters

fieldslist of stringsOptional

A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.

exclude_fieldslist of stringsOptional

A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

countintegerOptional<=1000Defaults to 10

The number of records to return. Default value is 10. Maximum value is 1000

offsetintegerOptionalDefaults to 0

Used for pagination, this is the number of records from a collection to skip. Default value is 0.

typestringOptional

The file type for the File Manager file.

created_bystringOptional

The Mailchimp account user who created the File Manager file.

before_created_atstringOptional

Restrict the response to files created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

since_created_atstringOptional

Restrict the response to files created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

sort_fieldenumOptional

Returns files sorted by the specified field.

Allowed values:

sort_direnumOptional

Determines the order direction for sorted results.

Allowed values:

Response

This endpoint returns an object.

_linkslist of objectsOptionalRead-only

A list of link types and descriptions for the API schema documents.

fileslist of objectsOptional

A list of files and images in an account.

total_file_sizedoubleOptionalRead-only

The total size of all File Manager files in bytes.

total_itemsintegerOptionalRead-only

The total number of items matching the query regardless of pagination.