Skip to content
Ads API •References / assets / Get Assets By Ad Account

Get Assets By Ad Account

Returns list of asset metadata in descending order via the creation time within each asset type for a given ad account ID.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • asset_type
    string
    Required

    The type of asset.

    Example value: "IMAGE"Allowed values: "AUDIO", "IMAGE", "VIDEO"
  • limit
    integer

    Limit or page size for a given response.

    Example value: 50Default value: 50Range: 1 - 50
  • offset
    integer

    Starting position of the next record to assist in data pagination.

    Example value: 0Default value: 0

Response

List of asset metadata objects.

    • page_size
      integer [int32]
    • total_results
      integer [int32]
    • offset
      integer [int32]
    • current_page
      integer [int32]
  • assets
    array of oneOfs
    Will be one of the following:
    • Metadata object for an image asset type.

    • Metadata object for an audio asset type.

    • Metadata object for a video asset type.

Response sample

{  "paging": {    "page_size": 50,    "total_results": 116,    "offset": 0  },  "assets": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "name": "logoImage.png",      "status": "READY",      "url": "https://i.scdn.co/image/123",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "image_type": "COMPANION",      "file_type": "JPEG"    },    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "name": "logoImage.png",      "status": "READY",      "url": "https://i.scdn.co/image/123",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "image_type": "COMPANION",      "file_type": "JPEG"    }  ]}