The Asset Status API lets you check what deliveries are required to publish your title and the current status of each delivery (e.g. success, failed, missing)—and if not, why. Centralize your asset delivery data in your own systems instead of manually checking Slate, giving you real-time visibility across all your deliveries and asset types. You are able to use the Asset Status API to view any of the data currently available in the Assets tab in Slate.
Why Use the Asset Status API?
- Centralized Operations – Pull asset delivery data directly into your own systems alongside your other distribution channels—no need to log into Slate for every status check
- Faster Issue Resolution – Detect delivery issues immediately and understand what’s blocking your titles from going live, reducing resolution time
- Proactive Asset Management – Monitor your entire catalog programmatically across all territories and asset types, enabling you to scale operations as your business grows
- Real-Time Delivery Verification – Know instantly when your assets are successfully delivered or if there are errors requiring action
Request format
The Asset Status API uses a simple retrieve via GET request structure where all query parameters are passed through the URL—no request body is required. This makes it easy to integrate into your systems and test using standard HTTP clients or command-line tools. Simply construct the URL with your title identifier and optional filters, then send a GET request to retrieve the current status of your asset deliveries.
https://partnerapi.primevideo.com/v1/assets/{licensor}/status/{ALID}?marketplace={marketplace}
This table defines the parameters you can use to query asset status information.
Parameter |
Type |
Is mandatory |
Description |
licensor |
String |
Yes |
Your organization identifier provided by Prime Video during onboarding |
ALID |
String |
Yes |
Title identifier (ALID or SKU) matching your contribution |
marketplace |
String |
No |
The Amazon Marketplace that the title was submitted to. This defaults to GLOBAL and is not required to be provided. If you are looking for a title in your Classic Marketplace catalog, please designate which one as a parameter. Allowed Values: GLOBAL, US, DE, JP, GB |
Example Requests
https://partnerapi.primevideo.com/v1/assets/mgm/status/skuabc123?marketplace=global
https://partnerapi.primevideo.com/v1/assets/mgm/status/skuabc123
Note: The more specific your request parameters, the more targeted your response will be. If you omit the optional marketplace parameter, the API will return status information for all applicable scopes associated with that ALID.
Response Schema
The response schema defines the structure of data returned by the Asset Status API. Understanding these data types will help you parse the response and integrate status information into your systems effectively.
ProductStatus
The top-level response containing asset status information for the requested title. Each response includes status data filtered by your request parameters, allowing you to understand the delivery state across different asset types and requirements.
Field Name |
Type |
Is mandatory |
Description |
Source |
DeliveryPlatform |
Yes |
Source delivery platform. Note this should always be Prime Video. |
Destination |
DeliveryPublisher |
Yes |
The partner alias for the title receiving the assets. |
Scope |
DeliveryScope |
Yes |
Delivery scope information |
PlatformIDs |
PlatformIdentifiers |
Yes |
Platform identifiers |
OverallProgressCode |
ProgressCode |
Yes |
Overall progress code: Ready, Issue, In-Process, Missing |
ProgressDetail |
ProgressDetailItem[] |
Yes |
List of progress details |
TitlePartStatus |
ProductTitlePartStatus[] |
Yes |
Title part status information |
Instructions |
ProductDeliveryInstruction[] |
No |
Delivery instructions |
DeliveryPlatform Type
Source delivery platform information.
Field Name |
Type |
Is mandatory |
Description |
Platform |
String |
Yes |
Source delivery platform. Note this should always be Prime Video. |
DeliveryPublisher Type
Destination publisher information. This identifies your organization as the content recipient.
Field Name |
Type |
Is mandatory |
Description |
Publisher |
String |
Yes |
The partner alias for the title receiving the assets. |
DeliveryScope Type
Delivery scope information defining the context of the asset status query.
Field Name |
Type |
Is mandatory |
Description |
ALID |
String |
Yes |
Asset Logical Identifier or SKU |
Marketplace |
String |
Yes |
The Amazon Marketplace that the title was submitted to. This defaults to GLOBAL and is not required to be provided. |
Region |
String |
No |
Region or territory |
FormatProfile |
String |
No |
Quality of availed video. Allowed values: SD, HD, UHD, MAX |
LicenseType |
String |
No |
Allowed values: SVOD, FVOD, EST, POEST, VOD |
BenefitID |
String |
No |
Identifier for a channel or subscription (required for SVOD offers) |
PlatformIdentifiers Type
Platform identifiers structure containing title identifiers.
Field Name |
Type |
Required |
Description |
GTI |
String |
Yes |
Global Title Identifier |
PublisherIDs |
PublisherIdentifier[] |
Yes |
Publisher identifiers |
PublisherIdentifier Type
The list of partner provided IDs.
Field Name |
Type |
Required |
Description |
ALID |
String |
Yes |
Title Identifier |
Marketplace |
String |
Yes |
The Amazon Marketplace that the title was submitted to. This defaults to GLOBAL and is not required to be provided. |
ProgressCode Type
Progress code enumeration values indicating the overall status of asset delivery.
Value |
Description |
Ready |
Assets have been ingested |
Issue |
There is an issue with asset delivery or processing |
In-Process |
Assets are being delivered and processed |
Missing |
A specific asset has not been delivered yet |
ProgressDetailItem Type
Progress detail item structure providing summary statistics.
Field Name |
Type |
Required |
Description |
Progress |
ProgressCode |
Yes |
Progress code |
Total |
Long |
Yes |
Total count of assets |
ActionNeeded |
Long |
Yes |
Number of assets from the total count that require action |
ProductTitlePartStatus Type
The core data structure representing the status of a single required asset delivery. This includes delivery status, action requirements, and detailed transaction-level data.
Field Name |
Type |
Is mandatory |
Description |
PrimaryType |
String |
Yes |
The Primary Type of the Asset |
SecondaryType |
String |
Yes |
Secondary type - For example for if the primary type was IMAGE the subtype might be 2x3 or Poster |
FormatProfile |
String |
No |
Format profile or quality |
Locale |
String |
No |
Locale - ex en-US or es-419 |
OfferContexts |
DeliveryScope[] |
Yes |
Each OfferContext represents a specific offer configuration (region, license type, format profile, etc.) that uses the asset |
ConditionalTitleParts |
ProductConditionalTitlePart[] |
No |
Conditional title parts |
RuleType |
String |
Yes |
Rule type: required, recommended, conditional |
ActionType |
String |
Yes |
Action type |
RuleSources |
String[] |
Yes |
Rule sources |
LastDelivery |
ProductDelivery |
No |
Last delivery information |
PriorSuccessfulDelivery |
ProductDelivery |
No |
Prior successful delivery information |
FirstDeliveryDate |
String |
No |
First delivery date |
Progress |
ProgressCode |
Yes |
Progress code: Ready, Issue, In-Process, Missing |
ExpectedDate |
String |
No |
Expected delivery date |
EarliestStartDate |
String |
No |
Earliest start date |
Common PrimaryType Values
The PrimaryType field identifies the category of asset being delivered.
Value |
Description |
METADATA |
Title metadata (descriptions, cast, crew, etc.) |
VIDEO |
Video mezzanine files |
IMAGE |
Artwork (box art, cover art, hero images, posters) |
AUDIO |
Audio tracks |
TIMED_TEXT |
Subtitles and captions |
Common ActionType Values
The ActionType field indicates whether you need to take action on a specific asset delivery.
Value |
Description |
ACTION_NEEDED |
Asset is missing or has errors that must be resolved for title to publish |
ACTION_RECOMMENDED |
Asset is not required but recommended for better customer experience |
NO_ACTION_NEEDED |
Asset is successfully delivered, no action required |
Common RuleType Values
The RuleType field defines whether an asset is mandatory or optional for your title to publish.
Value |
Description |
required |
Must be delivered for title to publish |
recommended |
Not required but improves customer experience |
conditional |
Required only if certain conditions are met |
ProductConditionalTitlePart Type
Conditional title part structure defining conditional requirements for asset delivery.
Field Name |
Type |
Is mandatory |
Description |
RuleType |
String |
Yes |
Rule type |
Regions |
String[] |
Yes |
List of regions or territories |
TitleParts |
ProductTitlePartDescriptor[] |
Yes |
Title parts |
RuleType Values
The RuleType field defines the logical relationship between conditional title parts.
Value |
Description |
NESTED |
All title parts in the structure must be satisfied (AND logic) |
SINGLE |
Any one of the title parts satisfies the requirement (OR logic) |
ProductTitlePartDescriptor Type
Title part descriptor structure defining a specific title part requirement.
Field Name |
Type |
Is mandatory |
Description |
PrimaryType |
String |
Yes |
The Primary Type of the Asset |
SecondaryType |
String |
Yes |
Secondary type - For example for if the primary type was IMAGE the subtype might be 2x3 or Poster |
FormatProfile |
String |
No |
Format profile or quality |
Locale |
String |
No |
Locale - ex en-US or es-419 |
ProductDelivery Type
Product delivery information providing detailed information about an asset delivery. This field will be null if the asset has not been delivered yet.
Field Name |
Type |
Is mandatory |
Description |
Status |
String |
No |
Delivery status - NOT_DELIVERED or SUCCESSFULLY_DELIVERED |
FileName |
String |
No |
File name |
Hash |
String |
No |
File hash or checksum |
DeliveredDate |
String |
No |
Delivered date in ISO 8601 format |
Locale |
String |
No |
Locale |
ServiceProvider |
String |
No |
Service provider or delivery account |
PresentationType |
String |
No |
Presentation type |
DynamicRangeType |
String |
No |
Dynamic range type |
Instructions |
ProductDeliveryInstruction[] |
No |
Delivery instructions or errors |
Common Status Values
The Status field indicates whether an asset delivery was successfully received and processed.
Value |
Description |
SUCCESSFULLY_DELIVERED |
Asset was successfully delivered and processed |
NOT_DELIVERED |
Asset has not been received |
ProductDeliveryInstruction Type
Product delivery instruction structure providing error codes and status information. Instructions can appear at the top-level response (summarizing all delivery issues) or within ProductDelivery objects (specific to individual asset deliveries).
Field Name |
Type |
Is mandatory |
Description |
TitlePart |
ProductTitlePartDescriptor |
No |
Title part descriptor |
TitlePartStatus |
String |
No |
Title part delivery status |
ErrorCode |
String |
No |
Error code |
Regions |
String[] |
No |
List of regions or territories |
Common TitlePartStatus Values
The TitlePartStatus field indicates the delivery status of an asset within instruction messages.
Value |
Description |
NOT_DELIVERED |
Asset has not been delivered |
SUCCESSFULLY_DELIVERED |
Asset was successfully delivered |
Note: The schemas above represent the current API response structure and may be enhanced in future releases.
Example 1: All Assets Successfully Delivered
This example demonstrates a typical API response for a movie title where all required assets have been successfully delivered. The response shows Ready status with no action needed.
{
"Destination": {
"Publisher": "TheDogChannel"
},
"Instructions": [],
"OverallProgressCode": "Ready",
"PlatformIDs": {
"GTI": "amzn1.dv.gti.e627fc28-5fde-435f-bc4e-44a9bad712df",
"PublisherIDs": [
{
"ALID": "FunWithTennisBalls",
"Marketplace": "GLOBAL"
}
]
},
"ProgressDetail": [
{
"ActionNeeded": 0,
"Progress": "Ready",
"Total": 11
}
],
"Scope": {
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": null,
"LicenseType": null,
"Marketplace": "GLOBAL",
"Region": null
},
"Source": {
"Platform": "Prime Video"
},
"TitlePartStatus": [
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["US"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": null,
"Locale": null,
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
}
]
}
],
"EarliestStartDate": "Wed Jun 01 04:00:00 UTC 2022",
"ExpectedDate": null,
"FirstDeliveryDate": null,
"FormatProfile": null,
"LastDelivery": {
"DeliveredDate": "Mon Feb 26 22:56:53 UTC 2024",
"DynamicRangeType": null,
"FileName": "passionflix_82_this-side-of-heaven_v5_MEC.xml",
"Hash": "3f73286984d4c71fd7a341c9b16be3ff",
"Instructions": null,
"Locale": "en-us",
"PresentationType": null,
"ServiceProvider": "stockholmstream",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": null,
"OfferContexts": [
{
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": "HD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "METADATA",
"PriorSuccessfulDelivery": {
"DeliveredDate": "Wed May 31 04:32:00 UTC 2023",
"DynamicRangeType": null,
"FileName": "fun_with_v4_MEC.xml",
"Hash": null,
"Instructions": null,
"Locale": "en-us",
"PresentationType": null,
"ServiceProvider": "thepound",
"Status": null
},
"Progress": "Ready",
"RuleSources": ["PUBLISHING_SPEC"],
"RuleType": "REQUIRED",
"SecondaryType": "NONE"
},
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["US"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": "HD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
}
]
}
],
"EarliestStartDate": "Wed Jun 01 04:00:00 UTC 2022",
"FormatProfile": "HD",
"LastDelivery": {
"DeliveredDate": "Mon Feb 27 14:59:03 UTC 2023",
"DynamicRangeType": "SDR",
"FileName": "fun_with_tennis_mwf5.mp4",
"Hash": "88cbed6edabce11b9b503130081e7bd8",
"Instructions": null,
"Locale": "en-us",
"PresentationType": "MAIN",
"ServiceProvider": "thepound",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": null,
"OfferContexts": [
{
"ALID": "FunWithTennisBalls",
"BenefitID": "dogchannel",
"FormatProfile": "HD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "VIDEO",
"Progress": "Ready",
"RuleType": "REQUIRED",
"SecondaryType": "MEZZ"
}
]
}
Example 2: Missing Required Assets
This example demonstrates an API response when required assets are missing, showing how the API indicates ACTION_NEEDED status and provides error information.
{
"Destination": {
"Publisher": "1cendgametestpartner1"
},
"Instructions": [
{
"ErrorCode": null,
"Regions": null,
"TitlePart": {
"FormatProfile": "SD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
},
"TitlePartStatus": "NOT_DELIVERED"
},
{
"ErrorCode": null,
"Regions": null,
"TitlePart": {
"FormatProfile": "HD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
},
"TitlePartStatus": "NOT_DELIVERED"
},
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": {
"FormatProfile": null,
"Locale": "ja",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
},
"TitlePartStatus": "SUCCESSFULLY_DELIVERED"
}
],
"OverallProgressCode": "Issue",
"ProgressDetail": [
{
"ActionNeeded": 0,
"Progress": "Ready",
"Total": 8
},
{
"ActionNeeded": 2,
"Progress": "Missing",
"Total": 2
}
],
"Scope": {
"ALID": "TLCPVAPITVSKU001EP4",
"BenefitID": null,
"FormatProfile": null,
"LicenseType": null,
"Marketplace": "GLOBAL",
"Region": null
},
"TitlePartStatus": [
{
"ActionType": "ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["DE", "PR", "AU", "JP", "GB", "US", "CA"],
"RuleType": "NESTED",
"TitleParts": [
{
"FormatProfile": "SD",
"Locale": null,
"PrimaryType": "VIDEO",
"SecondaryType": "MEZZ"
}
]
}
],
"EarliestStartDate": "Thu Jan 09 15:00:00 UTC 2025",
"FormatProfile": "SD",
"LastDelivery": null,
"Locale": null,
"OfferContexts": [
{
"ALID": "TLCPVAPITVSKU001EP4",
"BenefitID": "Prime",
"FormatProfile": "SD",
"LicenseType": "SVOD",
"Marketplace": "GLOBAL",
"Region": "US"
}
],
"PrimaryType": "VIDEO",
"PriorSuccessfulDelivery": null,
"Progress": "Missing",
"RuleSources": ["PUBLISHING_SPEC"],
"RuleType": "REQUIRED",
"SecondaryType": "MEZZ"
},
{
"ActionType": "NO_ACTION_NEEDED",
"LastDelivery": {
"DeliveredDate": "Tue Sep 24 01:04:20 UTC 2024",
"FileName": "1cendgametestpartner1-TLCPVAPITVSKU001EP4_MEC.xml",
"Instructions": [
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": null,
"TitlePartStatus": null
}
],
"Locale": "ja-jp",
"ServiceProvider": "1cendgametestpartner",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": "ja",
"PrimaryType": "METADATA",
"Progress": "Ready",
"RuleType": "RECOMMENDED",
"SecondaryType": "NONE"
},
{
"ActionType": "NO_ACTION_NEEDED",
"ConditionalTitleParts": [
{
"Regions": ["DE"],
"RuleType": "SINGLE",
"TitleParts": [
{
"FormatProfile": null,
"Locale": "de",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
},
{
"FormatProfile": null,
"Locale": "en",
"PrimaryType": "METADATA",
"SecondaryType": "NONE"
}
]
}
],
"LastDelivery": {
"DeliveredDate": "Tue Sep 24 01:04:20 UTC 2024",
"FileName": "1cendgametestpartner1-TLCPVAPITVSKU001EP4_MEC.xml",
"Instructions": [
{
"ErrorCode": "mec-validation-waiting-for-parent-sku-warning",
"Regions": [],
"TitlePart": null,
"TitlePartStatus": null
}
],
"Locale": "de-de",
"ServiceProvider": "1cendgametestpartner",
"Status": "SUCCESSFULLY_DELIVERED"
},
"Locale": "de",
"PrimaryType": "METADATA",
"Progress": "Ready",
"RuleType": "RECOMMENDED",
"SecondaryType": "NONE"
}
]
}
