How to get app version release date using the App Store Connect API

Question

Created Nov ’21

Replies 3

Boosts 3

Views 4.4k

Participants 3

Using the App Store Connect API how can you get the release date for an app? I've been able to use this endpoint to list a bunch of information, however the release date is not included.

As you can see in the JSON response posted below, it does have a "createdDate" but this corresponds to when the version was made in App Store Connect (Prepare for Submission), not when it was released to the store. This can be verified by looking in App Store connect.

JSON Response: https://api.appstoreconnect.apple.com/v1/apps/395389919/appStoreVersions?limit=1

{
    "data": [
        {
            "type": "appStoreVersions",
            "id": "a75acc6e-9429-4539-a282-eadef235169e",
            "attributes": {
                "platform": "IOS",
                "versionString": "5.9.0",
                "appStoreState": "READY_FOR_SALE",
                "copyright": "InterPro Solutions, LLC",
                "releaseType": "MANUAL",
                "earliestReleaseDate": null,
                "usesIdfa": null,
                "downloadable": true,
                "createdDate": "2021-10-11T08:37:22-07:00"
            },
            "relationships": {
                "ageRatingDeclaration": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/ageRatingDeclaration",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/ageRatingDeclaration"
                    }
                },
                "appStoreVersionLocalizations": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/appStoreVersionLocalizations",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/appStoreVersionLocalizations"
                    }
                },
                "build": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/build",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/build"
                    }
                },
                "appStoreVersionPhasedRelease": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/appStoreVersionPhasedRelease",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/appStoreVersionPhasedRelease"
                    }
                },
                "routingAppCoverage": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/routingAppCoverage",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/routingAppCoverage"
                    }
                },
                "appStoreReviewDetail": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/appStoreReviewDetail",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/appStoreReviewDetail"
                    }
                },
                "appStoreVersionSubmission": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/appStoreVersionSubmission",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/appStoreVersionSubmission"
                    }
                },
                "idfaDeclaration": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/idfaDeclaration",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/idfaDeclaration"
                    }
                },
                "appClipDefaultExperience": {
                    "links": {
                        "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/relationships/appClipDefaultExperience",
                        "related": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e/appClipDefaultExperience"
                    }
                }
            },
            "links": {
                "self": "https://api.appstoreconnect.apple.com/v1/appStoreVersions/a75acc6e-9429-4539-a282-eadef235169e"
            }
        }
    ],
    "links": {
        "self": "https://api.appstoreconnect.apple.com/v1/apps/395389919/appStoreVersions?limit=1",
        "next": "https://api.appstoreconnect.apple.com/v1/apps/395389919/appStoreVersions?cursor=AQ.ANZyDDk&limit=1"
    },
    "meta": {
        "paging": {
            "total": 68,
            "limit": 1
        }
    }
}

Screen Shot 2021-11-24 at 6.22.21 AM.png

Boost

Answer 1

revoceci OP

May ’23

Experiencing the same problem here: earliestReleaseDate is always nil

0

Answer 2

revoceci OP

May ’23

EDIT: earliestReleaseDate seems to be the date selected when configuring automatic release in appstoreconnect.

Seems like currently it is not possible to obtain the release date for a specific AppStoreVersion using the REST API. The closest I have come, is to obtain the phasedRelease StartDate

0

Answer 3

pyrtsa-sanoma OP

Feb ’24

Same here. Especially when manually releasing to all or with phased rollout, there is no earliestReleaseDate to be found.

Phased releases have a startDate which can be used as a workaround, but in case releasing to all users at once, there is no way to access the release date via App Store Connect API, as far I can see.

I would expect all released, regardless of release method, to have an earliestReleaseDate. And in case of phased releases, the startDate should simply match that.

Filed FB13617347 just now.

0