Video Central

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

This read-only API allows you to send a request with your title identifier (ALID/SKU) and receive real-time status information for each required asset delivery. You can optionally filter your request by marketplace to target specific delivery requirements.

What You’ll Receive:
Status information for each required asset, including the action type and detailed delivery information. Each status tells you where your need to focus your attention:

Action Needed: An action is required on that particular asset in order for the title to publish. This could mean that the asset was delivered but is in error, or was not delivered at all.
Action Recommended: An action is not necessary for the title to publish, but we recommend the partner take action to increase title performance e.g. localized artwork.
No Action Needed: No further action required.

Request and Response Schemas

This section provides technical specifications for developers to integrate the Asset Status API into their systems. Use this reference to understand the request format, response structure, and data types returned by the API.

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.

Parameters
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

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. Allowed Values: GLOBAL, US, DE, JP, GB
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. Allowed Values: GLOBAL, US, DE, JP, GB

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.

Sample Response

The following examples demonstrate typical API responses for different scenarios. Use these to understand the response structure and how to interpret status information.

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.

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.

Use case: You’ve submitted metadata for a TV episode but haven’t delivered the video files yet. The API shows which video formats are missing and blocking publication.

Key differences from Example 1:

OverallProgressCode is “Issue” instead of “Ready”
ProgressDetail shows ActionNeeded count of 2
TitlePartStatus entries with ActionType “ACTION_NEEDED” have null LastDelivery
Instructions array at top level shows NOT_DELIVERED status
Some delivered assets have validation warnings in their Instructions

FAQs

The following sections provide answers to common questions about working with the Asset Status API.

The instructions array provides detailed error codes and status information:

Top-level Instructions - Summary of all delivery issues across all assets
ProductDelivery Instructions - Specific warnings or errors for individual asset deliveries
ErrorCode - Identifies the specific issue (e.g., validation warnings, missing dependencies)
TitlePartStatus - Shows whether the asset was delivered (SUCCESSFULLY_DELIVERED, NOT_DELIVERED)