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

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
        }
    }
}

Post not yet marked as solved Up vote post of rspoon3 Down vote post of rspoon3
3.4k views
Posted by
rspoon3
Reply
Add a Comment

Replies

Experiencing the same problem here: earliestReleaseDate is always nil

Posted by
revoceci
Up vote reply of revoceci Down vote reply of revoceci
Add a Comment

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

Posted by
revoceci
Up vote reply of revoceci Down vote reply of revoceci
Add a Comment

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.

Posted by
pyrtsa-sanoma
Up vote reply of pyrtsa-sanoma Down vote reply of pyrtsa-sanoma
Add a Comment