Assets

GET Get assets by simple filter

GET /asset/v1/content/assets

Operation ID: getAssetsSimpleQuery.

Retrieve a collection of assets by applying basic filters and sorting rules.

Parameters

• Authorization (header, string, required) A unique, time-limited token that you can use to issue requests to the Marketing Cloud Engagement API. Replace YOUR_ACCESS_TOKEN with your Marketing Cloud Engagement API authentication token.

  Example

  Bearer YOUR_ACCESS_TOKEN

• $page (query, integer) Page number to return from the paged results. Start with 1 and continue until you get zero results. Typically provided along with the $pagesize parameter.
• $pagesize (query, integer) Number of results per page to return. Typically provided along with the $page parameter.
• $orderBy (query, string) Determines which property to use for sorting, and also determines the direction in which to sort the data. If you don’t provide the $orderBy parameter, results are sorted by ID in ascending order. For assets, use asset property name. For categories, use a property name, such as name asc.
• $filter (query, string) Filter by property using a simple operator and value. For GET /assets, filter by an asset's property. For GET /categories, filter by ParentId. ParentId is the only allowed field.
• $fields (query, string) Comma-delimited string of asset properties used to reduce the size of your results to only the properties you need. Used only for GET /asset/v1/content/assets.

Responses

• 200 Indicates that the assets were retrieved successfully.

  Media type: application/json. Schema: AssetCollectionResponse.

  Example

  {
    "count": 1,
    "page": 1,
    "pageSize": 25,
    "links": {},
    "items": [
      {
        "id": 999999,
        "customerKey": "e433dd9b-82a9-44cc-a3e3-66b8ed60550a",
        "assetType": {
          "id": 28,
          "name": "png",
          "displayName": "Image"
        },
        "fileProperties": {
          "extension": "png",
          "fileSize": 6578,
          "fileCreatedDate": "2026-02-16T15:16:26.8284748-08:00",
          "width": 500,
          "height": 107,
          "publishedURL": "https://image.s4.sfmc-content.com/lib/ef3785739738647c7a77/m/1/NTOLogoHeader_small.png"
        },
        "name": "NTOLogoHeader_small",
        "description": "Northern Trail Logo Header Small",
        "modelVersion": 2
      }
    ]
  }

• 400 Indicates that the request contained information that the API couldn’t process. If you receive a 400 response, verify that the request uses the correct syntax.

  Media type: application/json. Schema: ApiError.

• 403 This response indicates that the API accepted your request but couldn’t authorize it. If you receive a 403 response, make sure that you have the necessary permission scope for the operation. You can modify permission scopes on the Installed Apps page in Marketing Cloud Engagement Setup.

  Media type: application/json. Schema: ApiError.

  Example

  {
    "message": "Insufficient Privileges to complete this action.",
    "errorcode": 20002,
    "documentation": ""
  }