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: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
asset_ids
array of strings
Unique items
A unique identifier for the entity.
Example: asset_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
asset_types
array of strings
Unique items
The type of asset.
Allowed values: "AUDIO", "IMAGE", "VIDEO"Example: asset_types=IMAGE
asset_subtypes
array of strings
Unique items
The general type of audio asset, with ADSTUDIO_SUPPLIED_AUDIO and USER_UPLOADED_AUDIO being included as part of the AUDIO_AD categorization.
Allowed values: "AUDIO_AD", "BACKGROUND_MUSIC"Example: asset_subtypes=AUDIO_AD
statuses
array of strings
Unique items
The current status of an asset throughout lifecycle processes.
Allowed values: "ERROR", "PROCESSING", "READY", "WAITING_UPLOAD"Example: statuses=READY
aspect_ratios
array of strings
Unique items
String representation of all supported aspect ratios
Allowed values: "HORIZONTAL_16_9", "HORIZONTAL_1_91_1", "SQUARE", "VERTICAL_9_16"
name
string
Search word provided is applied to the asset name.
sort_direction
string
Default: sort_direction=DESCAllowed values: "ASC", "DESC"
sort_field
string
Allowed values: "CREATED_AT", "NAME"
limit
integer
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offset
integer
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=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.
  id
  string [uuid]
  Required
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  name
  string
  Required
  The name of the asset file.
  Example: "logoImage.png"
  asset_type
  string
  Required
  status
  string
  Required
  The current status of an asset throughout lifecycle processes.
  Allowed values: "ERROR", "PROCESSING", "READY", "WAITING_UPLOAD"Example: "READY"
  url
  string [uri]
  URL of asset. Will be either Google Cloud Storage URL or CDN URL depending on the asset type and the transcoding completion status.
  Example: "https://i.scdn.co/image/123"
  created_at
  string [date-time]
  Required
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  updated_at
  string [date-time]
  Required
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  file_type
  string
  The file type of the image asset as defined by the 'file type' specification of the ISO base media file format standard.
  Allowed values: "JPEG", "PNG"Example: "JPEG"
  aspect_ratio
  string
  String representation of all supported aspect ratios
  Allowed values: "HORIZONTAL_16_9", "HORIZONTAL_1_91_1", "SQUARE", "VERTICAL_9_16"
  width
  integer
  Example: 720
  height
  integer
  Example: 1280
- Metadata object for an audio asset type.
  id
  string [uuid]
  Required
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  name
  string
  Required
  The name of the asset file.
  Example: "logoImage.png"
  asset_type
  string
  Required
  status
  string
  Required
  The current status of an asset throughout lifecycle processes.
  Allowed values: "ERROR", "PROCESSING", "READY", "WAITING_UPLOAD"Example: "READY"
  url
  string [uri]
  URL of asset. Will be either Google Cloud Storage URL or CDN URL depending on the asset type and the transcoding completion status.
  Example: "https://i.scdn.co/image/123"
  created_at
  string [date-time]
  Required
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  updated_at
  string [date-time]
  Required
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  audio_type
  string
  The type of audio asset.
  Allowed values: "ADSTUDIO_SUPPLIED_AUDIO", "BACKGROUND_MUSIC", "STOCK_BACKGROUND_MUSIC", "USER_UPLOADED_AUDIO"Example: "USER_UPLOADED_AUDIO"
  duration_ms
  integer [int32]
  The duration of the asset in milliseconds. This value is populated as part of asset processing, and will be null until the asset is in ready state.
  Example: 30000
  file_type
  string
  The file type of the audio asset as defined by the 'file type' specification of the ISO base media file format standard.
  Allowed values: "MP3", "OGG", "WAV"
- Metadata object for a video asset type.
  id
  string [uuid]
  Required
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  name
  string
  Required
  The name of the asset file.
  Example: "logoImage.png"
  asset_type
  string
  Required
  status
  string
  Required
  The current status of an asset throughout lifecycle processes.
  Allowed values: "ERROR", "PROCESSING", "READY", "WAITING_UPLOAD"Example: "READY"
  url
  string [uri]
  URL of asset. Will be either Google Cloud Storage URL or CDN URL depending on the asset type and the transcoding completion status.
  Example: "https://i.scdn.co/image/123"
  created_at
  string [date-time]
  Required
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  updated_at
  string [date-time]
  Required
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
  duration_ms
  integer [int32]
  The duration of the asset in milliseconds. This value is populated as part of asset processing, and will be null until the asset is in ready state.
  Example: 30000
  aspect_ratio
  string
  String representation of all supported aspect ratios
  Allowed values: "HORIZONTAL_16_9", "HORIZONTAL_1_91_1", "SQUARE", "VERTICAL_9_16"
  width
  integer
  Example: 720
  height
  integer
  Example: 1280
  file_type
  string
  The file type of the video asset as defined by the 'file type' specification of the ISO base media file format standard.
  Allowed values: "MP4", "QUICKTIME"
  has_audio
  boolean
  thumbnail_url
  string [uri]
  URL of thumbnail image of the video asset.
  Example: "https://adstudio-video-preview-image.spotifycdn.com/123-preview"

Response sample

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