Skip to content

Get iOS App Info (v2)
Stable

Request

Looks up iOS app information by app ID or Apple app ID.

Returns a paginated list of ItunesAppInfoV2 records — app name, icon, developer, current version, and iTunes Store URL — matched by Esper's internal app_id, an Apple app ID, or a specific version_id, optionally scoped to an App Store country/region.

About iOS App Info

This is an iOS/VPP-specific endpoint (Android is not applicable) that surfaces iTunes/App Store metadata for apps managed through Esper's VPP App Management. It's the v2 replacement path for looking up iTunes app details tied to a tenant's VPP-managed iOS apps.

Key Fields / Query Parameters

  • app_id — Esper's internal UUID for the app
  • version_id — UUID of a specific app version
  • apple_app_id — the app's ID from Apple
  • country_code — ISO country code for the App Store region, defaults to "us"

Common Use Cases

  • Looking up current iTunes metadata (name, icon, version) for a VPP-managed iOS app
  • Resolving an Apple app ID to Esper's internal app_id for further API calls
Security
apps_management_apiKey
Query
app_idstring, (uuid)
version_idstring, (uuid)
apple_app_idstring
country_codestring^[a-zA-Z]{2}$

ISO country code for App Store region (e.g., "us", "gb", "de"). Defaults to "us".

Example:country_code=us
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/itunesapps?app_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&version_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&apple_app_id=string&country_code=us' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
contentobject
Response
{
  "content": {
    "count": 0,
    "prev": "string",
    "next": "string",
    "results": [ … ]
  }
}