API: List of Versions

Get meta information about all versions of an app. There are different endpoints for developers and for testers. Only the endpoint for developers returns all versions, even unreleased ones.

For Developers

Request

• URL:
  • https://rink.hockeyapp.net/api/2/apps/IDENTIFIER/app_versions
  • IDENTIFIER - required, replace with your public app identifier
• HTTP Method: GET
• Authentification: set the HTTP header X-HockeyAppToken to your API token (create one here)

Example:

curl \
  -H "X-HockeyAppToken: 4567abcd8901ef234567abcd8901ef23" \
  https://rink.hockeyapp.net/api/2/apps/0873e2b98ad046a92c170a243a8515f6/app_versions

Response

Status: 200
Body:

{
    "app_versions": [
        {
            "version": "208",
            "mandatory": false,
            "config_url": "https://rink.hockeyapp.net/manage/apps/1266/app_versions/208",
            "download_url":"https://rink.hockeyapp.net/apps/0873e2b98ad046a92c170a243a8515f6/app_versions/208
            "timestamp": 1326195742,
            "appsize": 157547,
            "device_family": null,
            "notes": "<p>Fixed bug when users could not sign in.</p>\n",
            "status": 2,
            "shortversion": "1.1",
            "minimum_os_version": null,
            "title": "HockeyApp"
        },
        {
            "version": "195",
            "mandatory": false,
            "config_url": "https://rink.hockeyapp.net/manage/apps/1266/app_versions/195",
            "timestamp": 1325597848,
            "appsize": 157591,
            "device_family": null,
            "notes": "<ul>\n<li>Added action bar with native support for Android 3.x and 4.0.</li>\n<li>Added grid view on Android tablets.</li>\n<li>Added &quot;Check for Updates&quot; to menu.</li>\n<li>Changed layout of detail view.</li>\n<li>Updated HockeySDK + various bug fixes.</li>\n</ul>\n",
            "status": 1,
            "shortversion": "1.1",
            "minimum_os_version": null,
            "title": "HockeyApp"
        },

        ...
    ],
    "status": "success"
}

For Testers

Request

• URL:
  • https://rink.hockeyapp.net/api/2/apps/IDENTIFIER?format=json
  • IDENTIFIER - required, replace with your public app identifier
• HTTP Method: GET

Response

Status: 200
Body:

[
    {
        "mandatory": false,
        "appsize": 157547,
        "notes": "<p>Fixed bug when users could not sign in.</p>\n",
        "title": "HockeyApp",
        "timestamp": 1326195742,
        "version": "208",
        "shortversion": "1.1"
    },
    {
        "mandatory": false,
        "appsize": 157591,
        "notes": "<ul>\n<li>Added action bar with native support for Android 3.x and 4.0.</li>\n<li>Added grid view on Android tablets.</li>\n<li>Added &quot;Check for Updates&quot; to menu.</li>\n<li>Changed layout of detail view.</li>\n<li>Updated HockeySDK + various bug fixes.</li>\n</ul>\n",
        "title": "HockeyApp",
        "timestamp": 1325597848,
        "version": "195",
        "shortversion": "1.1"
    },

    ...
]