---
title: "GET /list-apps"
method: GET
path: "/list-apps"
---

# GET /list-apps

`GET /list-apps`

## Request

- Base URL: `https://api.retellai.com`
- URL: `https://api.retellai.com/list-apps`
- Auth: HTTP bearer

List Apps in the organization (paginated).

## Query parameters

- `privacy_scope` 'standard' | 'pci': Privacy scope of an integration function.
- `limit` integer
- `sort_order` 'ascending' | 'descending'
- `pagination_key` string

## Response `200`

Page of Apps.

- object
  - `pagination_key` string: Pagination key for the next page.
  - `has_more` boolean, required: Whether more results are available.
  - `items` AppResponse[], required
    - `app_id` string, required
    - `org_id` string, required
    - `type` 'crm' | 'calendar' | 'knowledge_base' | 'support' | 'communication', required: App integration category.
    - `provider` string, required: Provider name. Must be valid for the App's type; the supported providers per type are listed by list-app-templates.
    - `connection_status` 'not_connected' | 'connected' | 'error': Connection health of the App, server-managed. `not_connected` after create or a credential / tenant URL change; `connected` once verified via OAuth connect, an auth test, or a successful live tool call; `error` when the provider rejects the credentials (on connect, an auth test, or a live tool call).
    - `name` string
    - `tenant_url` string: Per-tenant API base URL. Set by providers with per-org hosts; omitted by providers on a single global host. For OneDrive for Business, this is the tenant's -my.sharepoint.com origin used by File Picker v8; personal OneDrive omits it.
    - `tenant_type` 'business' | 'personal': Microsoft OneDrive account type discovered during OAuth.
    - `tenant_id` string: Sub-account id, for providers that scope requests by a sub-account id on a shared host. Omitted by every other provider.
    - `auth_config` union: Non-secret auth metadata. Encrypted secret fields are never returned by the API.
      - OAuthConfigResponse
        - `type` 'oauth2', required
        - `client_id` string, required
      - ApiKeyAuthConfigResponse
        - `type` 'api_key', required
      - AccessTokenAuthConfigResponse
        - `type` 'access_token', required
      - BasicAuthConfigResponse
        - `type` 'basic', required
        - `username` string, required
      - RefreshTokenAuthConfigResponse
        - `type` 'refresh_token', required
    - `crm_config` AppCRMConfig
      - `inbound_sync_mappings` CRMSyncMapping[]: Field mappings applied when syncing CRM records into Retell contacts. Must include phone_number, which is the field the two systems are matched on. A do_not_call mapping can mark contacts as do-not-call but never clears the flag.
        - `field_name` string, required: Retell contact field, built-in or custom, to map. Types must be compatible with the CRM field on both sides of the sync.
        - `external_field_name` string, required: Field on the CRM's contact object to map to. A name that does not exist there surfaces as an error on the sync job rather than at configuration time.
      - `outbound_sync_mappings` CRMSyncMapping[]: Field mappings applied when writing Retell contact changes back to the CRM.
        - `field_name` string, required: Retell contact field, built-in or custom, to map. Types must be compatible with the CRM field on both sides of the sync.
        - `external_field_name` string, required: Field on the CRM's contact object to map to. A name that does not exist there surfaces as an error on the sync job rather than at configuration time.
      - `sync_conversation_activity` boolean: Whether to push call/chat activity to the external CRM. Opt-in — defaults to false when unset.
      - `sync_new_contacts` boolean: Whether to create a CRM record after a conversation when the contact is not yet linked to one.
    - `created_timestamp` number, required
    - `user_modified_timestamp` number, required

## Other responses

- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-10-23** `6b720a56f4fb`: 1 info
  - added the new optional `query` request parameter `privacy_scope`
- **2026-10-16** `ca41f0dbb297`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retellai/apis/retell-sdk/changes/list-apps/get.md)

---

[API](https://skmtc.dev/retellai/apis/retell-sdk.md) - [All operations](https://skmtc.dev/retellai/apis/retell-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/retellai/apis/retell-sdk/revisions/e482acaa292c?raw)