---
title: "Get app settings"
method: GET
path: "/v1/apps/{app_id}"
tags: ["Apps"]
---

# Get app settings

`GET /v1/apps/{app_id}`

Get the settings and configuration for an app.

## Path parameters

- `app_id` string, required — The ID of the app.

## Headers

- `privy-app-id` string, required — ID of your Privy app.

## Response `200`

The app settings.

- AppResponse — The response for getting an app.
  - `accent_color` string, nullable, required
  - `allowed_domains` string[], required
  - `allowed_native_app_ids` string[], required
  - `allowed_native_app_url_schemes` string[], required
  - `allowlist_config` AppAllowlistConfig, required — Configuration for the allowlist error page shown to users not on the allowlist.
    - `cta_link` string, nullable, required
    - `cta_text` string, nullable, required
    - `error_detail` string, nullable, required
    - `error_title` string, nullable, required
  - `allowlist_enabled` boolean, required
  - `apple_oauth` boolean, required
  - `captcha_enabled` boolean, required
  - `captcha_site_key` string
  - `custom_api_url` string, nullable, required
  - `custom_jwt_auth` boolean, required
  - `custom_oauth_providers` AppCustomOAuthProvider[], required
    - `enabled` boolean, required
    - `provider` string, required — The ID of a custom OAuth provider, set up for this app. Must start with "custom:".
    - `provider_display_name` string, required
    - `provider_icon_url` string, required
  - `data_classification` 'public', required — Indicates that this response contains only publicly accessible data, not a privileged resource
  - `disable_plus_emails` boolean, required
  - `discord_oauth` boolean, required
  - `email_auth` boolean, required
  - `embedded_wallet_config` EmbeddedWalletConfigSchema, required — Configuration for embedded wallets including the mode.
    - `create_on_login` 'users-without-wallets' | 'all-users' | 'off', required — Whether to create embedded wallets on login.
    - `ethereum` EmbeddedWalletChainConfig, required — Chain-specific configuration for embedded wallets.
      - `create_on_login` 'users-without-wallets' | 'all-users' | 'off', required — Whether to create embedded wallets on login.
    - `require_user_owned_recovery_on_create` boolean
    - `require_user_password_on_create` boolean
    - `solana` EmbeddedWalletChainConfig, required — Chain-specific configuration for embedded wallets.
      - `create_on_login` 'users-without-wallets' | 'all-users' | 'off', required — Whether to create embedded wallets on login.
    - `user_owned_recovery_options` UserOwnedRecoveryOption[], required
    - `mode` 'legacy-embedded-wallets-only' | 'user-controlled-server-wallets-only', required — The mode for embedded wallets.
  - `enabled_captcha_provider` 'turnstile' | 'hcaptcha', required — The captcha provider enabled for an app.
  - `enforce_wallet_uis` boolean, required
  - `external_wallets_for_signup_enabled` boolean, required
  - `farcaster_auth` boolean, required
  - `farcaster_link_wallets_enabled` boolean, required
  - `fiat_on_ramp_enabled` boolean, required
  - `funding_config` FundingConfigResponseSchema — Configuration for funding and on-ramp options.
    - `cross_chain_bridging_enabled` boolean, required
    - `default_recommended_amount` string, required
    - `default_recommended_currency` Currency, required — A crypto currency identified by a CAIP-2 chain ID and optional asset.
      - `asset` 'native-currency' | 'USDC' — A currency asset type.
      - `chain` string, required — A valid CAIP-2 chain ID (e.g. 'eip155:1').
    - `methods` FundingMethodEnum[], required
    - `options` FundingOption[], required
      - `method` string, required
      - `provider` string, required
    - `prompt_funding_on_wallet_creation` boolean, required
  - `github_oauth` boolean, required
  - `google_oauth` boolean, required
  - `guest_auth` boolean, required
  - `icon_url` string, nullable, required
  - `id` string, required
  - `instagram_oauth` boolean, required
  - `legacy_wallet_ui_config` boolean, required
  - `line_oauth` boolean, required
  - `linkedin_oauth` boolean, required
  - `logo_url` string, nullable, required
  - `max_linked_wallets_per_user` number, nullable, required
  - `merge_accounts_by_email` boolean, required
  - `mfa_methods` MfaMethod[], required
  - `name` string, required
  - `passkey_auth` boolean, required
  - `passkeys_for_signup_enabled` boolean, required
  - `privacy_policy_url` string, nullable, required
  - `require_users_accept_terms` boolean, nullable, required
  - `show_wallet_login_first` boolean, required
  - `smart_wallet_config` union, required — The configuration object for smart wallets.
    - object — A disabled smart wallet configuration.
      - `enabled` false, required
    - object — An enabled smart wallet configuration.
      - `configured_networks` SmartWalletNetworkConfiguration[], required
        - `bundler_url` string, required
        - `chain_id` string, required
        - `chain_name` string
        - `paymaster_context` AlchemyPaymasterContext — The Alchemy paymaster context for a smart wallet network configuration.
          - `policy_id` string, uuid, required
        - `paymaster_url` string
        - `rpc_url` string
      - `enabled` true, required
      - `smart_wallet_type` 'safe' | 'kernel' | 'light_account' | 'biconomy' | 'coinbase_smart_wallet' | 'thirdweb' | 'nexus', required — The supported smart wallet providers.
      - `smart_wallet_version` string
  - `sms_auth` boolean, required
  - `solana_wallet_auth` boolean, required
  - `spotify_oauth` boolean, required
  - `telegram_auth` boolean, required
  - `telegram_auth_config` TelegramAuthConfigSchema — Configuration for Telegram authentication.
    - `bot_id` string, required
    - `bot_name` string, required
    - `link_enabled` boolean, required
    - `seamless_auth_enabled` boolean, required
  - `telegram_oauth` boolean, required
  - `terms_and_conditions_url` string, nullable, required
  - `theme` string, required
  - `tiktok_oauth` boolean, required
  - `twitch_oauth` boolean, required
  - `twitter_oauth` boolean, required
  - `twitter_oauth_on_mobile_enabled` boolean, required
  - `verification_key` string, required
  - `wallet_auth` boolean, required
  - `wallet_connect_cloud_project_id` string, nullable, required
  - `whatsapp_enabled` boolean, required

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)