---
title: "Get List of My Apps"
method: GET
path: "/apps"
tags: ["Apps"]
---

# Get List of My Apps

`GET /apps`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/apps`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

Apps that the user has access to (subscribed or not). If the user is the owner of the app, details will be returned with the private fields. Does not include the auto-managed default subscription app (`POST /apps/subscribe`); that client cannot be listed here or edited via OAuth client APIs.

## Response `200`

- App[]
  - `id` string, required: The primary key of the resource.
  - `name` string, required
  - `description` string
  - `client_id` string, required
  - `client_secret` string
  - `access_token_lifetime_seconds` number: Access token lifetime in seconds
  - `refresh_token_lifetime_seconds` number: Refresh token lifetime in seconds
  - `allowed_callback_urls` string: Allowed callback URLs (comma separated list)
  - `webhooks_url` string: Webhook URL to send the data (comma separated list)
  - `webhooks_authentication_header` object: Authentication header configuration for webhooks. Key-value pairs where both key and value are strings.
  - `allowed_logout_urls` string: Allowed logout URLs (comma separated list)
  - `created_at` string, date-time, required: Created at
  - `updated_at` string, date-time, required: Updated at
  - `deleted_at` string, date-time: Deleted at
  - `webhooks_url_mode` 'one_per_client' | 'one_per_subscription', required: Webhook URL mode
  - `owner_id` string
  - `user_is_subscribed_with_valid_tokens` boolean, required: Indicates whether the user is subscribed to the app and has valid authentication tokens (access or refresh).
  - `image_url` string: Image URL
  - `is_default_subscription_client` boolean: When true, this app is the default portal client for webhook subscriptions (one webhook URL per subscription).

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)