---
title: "One app, and where it stands"
method: GET
path: "/apps/{id}"
tags: ["Apps"]
---

# One app, and where it stands

`GET /apps/{id}`

## Request

- Base URL: `https://pagefully.com/api/v1`
- URL: `https://pagefully.com/api/v1/apps/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

The app.

- object
  - `app` App, required
    - `id` string, uuid, required
    - `name` string, required
    - `app_store_id` string, required
    - `bundle_id` string, required
    - `category` string, nullable, required
    - `icon_url` string, nullable, required
    - `locale` string, required
    - `has_key` boolean, required: Connected through an App Store Connect key. Without one the app can be planned and designed for, and not published.
    - `plan` 'free' | 'pack' | 'pro', required
    - `url` string, required: The app in the web app.
    - `listing` object: On GET /v1/apps/{id}: where the app's facts were read from.
      - `on_public_store` boolean, nullable, required: Whether the public App Store has the app. Null where that is not known.
      - `read_from` 'app_store_connect' | 'public_app_store', required
      - `note` string, nullable, required: One sentence when the app is not on the public store, or the store could not be read: where its facts came from, and why `category` or `icon_url` is empty.
    - `has_brief` boolean
    - `intents` integer
    - `pages` integer
  - `running_jobs` object[], required
    - `id` string, uuid, required
    - `type` string, required
    - `state` string, required

## Other responses

- `401`: No token, or one that is not valid or has been revoked.
- `404`: Not found on this workspace.
- `429`: Too many calls: 120 requests a minute for a token, and 20 generation starts an hour. `retry_after` is seconds.

---

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