---
title: "Get iOS App Info (v2)"
method: GET
path: "/v2/itunesapps"
tags: ["apps_management_VPP App Management"]
---

# Get iOS App Info (v2)

`GET /v2/itunesapps`

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

## Query parameters

- `app_id` string, uuid
- `version_id` string, uuid
- `apple_app_id` string
- `country_code` string

## Response `200`

Success

- object
  - `content` object
    - `count` integer — number of results returned
    - `prev` string — URL for previous page of results
    - `next` string — URL for next page of results
    - `results` AppsManagementItunesAppInfoV2[]
      - `app_id` string, uuid — App ID in UUID format
      - `apple_app_id` string — App ID from Apple
      - `app_version_id` string, uuid — current version of the app in UUID format
      - `apple_app_version` string — current version of the app
      - `app_name` string — name of the app
      - `icon_url` string — url of the app's icon
      - `developer` string — developer of the app
      - `itunes_url` string — URL for the app on the iTunes store
      - `genres` string[]
      - `device_families` string[]
      - `bundle_id` string — bundle ID of the app
      - `price` number — price of the app
      - `app_size` integer — size of the app
      - `minimum_os_version` string — minimum OS version required for the app
      - `description` string — description of the app
      - `last_updated_date` string — date the app was last updated
      - `pricing_param` string — pricing parameter

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.dev/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/6b55f43485ae/schema)
