---
title: "List apps"
method: GET
path: "/v2/apps"
tags: ["Apps"]
---

# List apps

`GET /v2/apps`

## Request

- Base URL: `https://api.tenjin.com`
- URL: `https://api.tenjin.com/v2/apps`
- Auth: HTTP bearer

## Query parameters

- `query` string
- `page` integer
- `per_page` integer

## Response `200`

Apps

- AppListDocument
  - `data` AppResource[], required
    - `id` string, uuid, required
    - `type` 'app', required
    - `attributes` object, required
      - `name` string, nullable, required: Name of the app
      - `bundle_id` string, nullable, required: Bundle id of the app in its store
      - `platform` 'amazon' | 'android' | 'android_other' | 'ios' | 'windows' | 'unspecified' | 'null', nullable, required: Platform of the app
      - `public_key` string, nullable, required: Google Play public key, used to validate in-app purchases
      - `ios_shared_secret` string, nullable, required: App Store shared secret, used to track subscription revenue
      - `amazon_shared_secret` string, nullable, required: Amazon Appstore shared key, used to validate in-app purchases
      - `store_id` string, nullable, required: Id of the app in its store
      - `released_on` string, date, nullable, required: Release date of the app in its store
      - `rating` string, nullable, required: Rating of the app in its store: a decimal number as a string
      - `price` integer, nullable, required: Price of the app in its store
      - `developer_name` string, nullable, required: Name of the app developer
      - `match_strings` string[], required: Strings that match campaigns to the app
      - `protocol` string, nullable, required: URL scheme of the app, used for Meta deep links
      - `facebook_referrer_decryption_key` string, nullable, required: Meta install referrer decryption key, used to decrypt Meta attribution data of an Android app
      - `created_at` string, date-time, nullable, required: When the app was added to Tenjin
      - `sending_events` boolean, required: Whether Tenjin has received events of the app
      - `deterministic_click_attribution_window` string, required: Duration literal: `0`, whole hours `1h` to `24h`, or whole days `1d` to `30d`. A whole number of days is returned in days, so `24h` comes back as `1d`
      - `deterministic_impression_attribution_window` string, required: Duration literal: `0`, whole hours `1h` to `24h`, or whole days `1d` to `30d`. A whole number of days is returned in days, so `24h` comes back as `1d`
      - `probabilistic_click_attribution_window` string, required: Duration literal: `0`, whole hours `1h` to `24h`, or whole days `1d` to `3d`. A whole number of days is returned in days, so `24h` comes back as `1d`
      - `probabilistic_impression_attribution_window` string, required: Duration literal: `0`, whole hours `1h` to `24h`, or whole days `1d` to `3d`. A whole number of days is returned in days, so `24h` comes back as `1d`
  - `links` Links, required
    - `self` string, uri, required: URL of this request
    - `first` string, uri: URL of the first page of a list
    - `prev` string, uri: URL of the previous page of a list
    - `next` string, uri: URL of the next page of a list
    - `last` string, uri: URL of the last page of a list
  - `meta` PageMeta, required
    - `count` integer, required: Number of items on all pages
    - `per_page` integer, required: Number of items per page

## Other responses

- `400`: A param is missing or invalid, a record is not found, or the request cannot be served
- `401`: Missing or invalid credentials, or no access to the requested data
- `403`: Invalid token, or the user's role does not allow the request
- `498`: Expired token, or a token with an invalid signature

---

[API](https://skmtc.dev/tenjin/apis/campaign-management-api.md) - [All operations](https://skmtc.dev/tenjin/apis/campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/campaign-management-api/revisions/e3cae1a03a92?raw)