---
title: "Retrieve App Store version history"
method: GET
path: "/appstore/version-history/{id}"
tags: ["AppStore"]
---

# Retrieve App Store version history

`GET /appstore/version-history/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/appstore/version-history/{id}`
- Auth: API key in header `x-api-key`

Returns an App Store app's version history, as shown under "What's New", by numeric track id, for an optional storefront country and language. Each entry has the version number, release date and timestamp, and release notes. A non-numeric id returns `400`.

## Path parameters

- `id` string, required

## Query parameters

- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AppstoreVersionHistoryResponseDoc
  - `code` integer
  - `data` AppstoreVersionHistoryItem[]
    - `release_date` string: Release date of the version, as `YYYY-MM-DD`.
    - `release_notes` string: Release notes of the version.
    - `release_timestamp` string: Release time of the version, in RFC 3339.
    - `version_display` string: Version number as shown on the App Store.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: App not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)