---
title: "List API Apps"
method: GET
path: "/api_app/list"
tags: ["Api App"]
---

# List API Apps

`GET /api_app/list`

Returns a list of API Apps that are accessible by you. If you are on a team with an Admin or Developer role, this list will include apps owned by teammates.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

successful operation

- ApiAppListResponse
  - `api_apps` ApiAppResponse[], required — Contains information about API Apps.
    - `callback_url` string, nullable — The app's callback URL (for events)
    - `client_id` string — The app's client id
    - `created_at` integer — The time that the app was created
    - `domains` string[] — The domain name(s) associated with the app
    - `name` string — The name of the app
    - `is_approved` boolean — Boolean to indicate if the app has been approved
    - `oauth` ApiAppResponseOAuth, nullable — An object describing the app's OAuth properties, or null if OAuth is not configured for the app.
      - `callback_url` string — The app's OAuth callback URL.
      - `secret` string, nullable — The app's OAuth secret, or null if the app does not belong to user.
      - `scopes` string[] — Array of OAuth scopes used by the app.
      - `charges_users` boolean — Boolean indicating whether the app owner or the account granting permission is billed for OAuth requests.
    - `options` ApiAppResponseOptions, nullable — An object with options that override account settings.
      - `can_insert_everywhere` boolean — Boolean denoting if signers can "Insert Everywhere" in one click while signing a document
    - `owner_account` ApiAppResponseOwnerAccount — An object describing the app's owner
      - `account_id` string — The owner account's ID
      - `email_address` string — The owner account's email address
    - `white_labeling_options` ApiAppResponseWhiteLabelingOptions, nullable — An object with options to customize the app's signer page
      - `header_background_color` string
      - `legal_version` string
      - `link_color` string
      - `page_background_color` string
      - `primary_button_color` string
      - `primary_button_color_hover` string
      - `primary_button_text_color` string
      - `primary_button_text_color_hover` string
      - `secondary_button_color` string
      - `secondary_button_color_hover` string
      - `secondary_button_text_color` string
      - `secondary_button_text_color_hover` string
      - `text_color1` string
      - `text_color2` string
  - `list_info` ListInfoResponse, required — Contains pagination information about the data returned.
    - `num_pages` integer — Total number of pages available.
    - `num_results` integer, nullable — Total number of objects available.
    - `page` integer — Number of the page being returned.
    - `page_size` integer — Objects returned per page.
  - `warnings` WarningResponse[] — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/revisions/7535b8f1a188/schema)