<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-asset-library-reference-data",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Asset Library reference data"
}
-->

# App Asset Library reference data

Discover the valid asset specifications, placement groups, and limits for placements.

## Discussion

The `appAssetLibraryRefData` resource represents reference data that describes the valid asset specifications, dimensions, placement groups, and per-placement limits for the asset library. Use it to:

- List the reference data for the asset library.
- Read a specific reference data resource.

Query the reference data to learn what’s valid for a placement type before you upload an asset, instead of hard-coding specifications.

## Topics

### Getting reference data

[`List app asset library ref data`](/documentation/AppStoreConnectAPI/GET-v1-appAssetLibraryRefData)

List app asset library reference data.

[`Read an app asset library ref data`](/documentation/AppStoreConnectAPI/GET-v1-appAssetLibraryRefData-_id_)

Get information about an app asset library reference data resource.

### Objects and types

[`object AppAssetLibraryRefDatum`](/documentation/AppStoreConnectAPI/AppAssetLibraryRefDatum)

Reference data that describes the valid asset specifications, placement groups, and limits for the asset library.

[`object AppAssetLibraryRefDataResponse`](/documentation/AppStoreConnectAPI/AppAssetLibraryRefDataResponse)

The response body for endpoints that list app asset library reference data.

[`object AppAssetLibraryRefDatumResponse`](/documentation/AppStoreConnectAPI/AppAssetLibraryRefDatumResponse)

The response body for endpoints that read an app asset library reference data resource.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)