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_idstring [uuid]Required
A unique identifier for an Ad Account.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- asset_typestringRequired
The type of asset.
Example value:"IMAGE"
Allowed values:"AUDIO"
,"IMAGE"
,"VIDEO"
- limitinteger
Limit or page size for a given response.
Example value:50
Default value:50
Range:1
-50
- offsetinteger
Starting position of the next record to assist in data pagination.
Example value:0
Default value:0
Response
List of asset metadata objects.
- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- assetsarray of oneOfsWill 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" } ]}