<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-screenshots",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Screenshots"
}
-->

# App Screenshots

Upload and download app screenshots for an app locale and display target.

## Discussion

An `appScreenshots` resource represents a single app screenshot for an app locale and display target. Use this resource to:

- Upload new app screenshots to App Store Connect.
- Download existing screenshots.

To upload screenshots, begin by creating an [App Screenshot Sets](/documentation/AppStoreConnectAPI/app-screenshot-sets) resource for the locale and display target. To upload screenshots, you must create an asset reservation, then follow the upload operations specified in the response.

> Important:
> Some screenshot sizes are required in order to submit your app for review. You’ll get an error at submission time if you don’t provide all of the required assets. For information about screenshot requirements, see [Screenshot specifications](https://developer.apple.com/help/app-store-connect/reference/screenshot-specifications).

## Topics

### Getting Screenshots and Reading Information

[`List all app screenshots for an app screenshot set`](/documentation/AppStoreConnectAPI/GET-v1-appScreenshotSets-_id_-appScreenshots)

List all ordered screenshots in a screenshot set.

[`Read app screenshot information`](/documentation/AppStoreConnectAPI/GET-v1-appScreenshots-_id_)

Get information about an app screenshot and its upload and processing status.

### Creating, Modifying, and Deleting Screenshots

[`Create an app screenshot`](/documentation/AppStoreConnectAPI/POST-v1-appScreenshots)

Add a new screenshot to a screenshot set.

[`Modify an app screenshot`](/documentation/AppStoreConnectAPI/PATCH-v1-appScreenshots-_id_)

Commit an app screenshot after uploading it.

[`Delete an app screenshot`](/documentation/AppStoreConnectAPI/DELETE-v1-appScreenshots-_id_)

Delete an app screenshot that is associated with a screenshot set.

### Objects

[`AppScreenshot`](/documentation/AppStoreConnectAPI/AppScreenshot)

The data structure that represent an App Screenshots resource.

[`AppScreenshotCreateRequest`](/documentation/AppStoreConnectAPI/AppScreenshotCreateRequest)

The request body you use to create an App Screenshot.

[`AppScreenshotUpdateRequest`](/documentation/AppStoreConnectAPI/AppScreenshotUpdateRequest)

The request body you use to update an App Screenshot.

[`AppScreenshotResponse`](/documentation/AppStoreConnectAPI/AppScreenshotResponse)

The response body for endpoints that create, read, or modify an app screenshot.

[`AppScreenshotsResponse`](/documentation/AppStoreConnectAPI/AppScreenshotsResponse)

The response body for endpoints that list screenshots in an app screenshot set.

[`UploadOperation`](/documentation/AppStoreConnectAPI/UploadOperation)

Upload instructions for assets such as app previews and app screenshots.


---

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)