---
title: "List Applications"
method: GET
path: "/v3/portals/{portalId}/applications"
tags: ["Applications"]
---

# List Applications

`GET /v3/portals/{portalId}/applications`

Lists applications in this portal. Each application can be registered for various APIs, issuing credentials for API access. If using DCR, an application will be linked to an Identity Provider's application by its `client_id`.

## Path parameters

- `portalId` string, uuid, required

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `sort` string
- `filter` FilterApplications
  - `developer_id` UuidFieldFilter — Filter using **one** of the following operators: `eq`, `oeq`, `neq`
    - `eq` string — The field exactly matches the provided value.
    - `oeq` string — The field matches any of the provided values.
    - `neq` string — The field does not match the provided value.
  - `name` StringFieldFilter — Filter using **one** of the following operators: `eq`, `oeq`, `neq`, `contains`, `ocontains`
    - `eq` string — The field exactly matches the provided value.
    - `contains` string — The field contains the provided value.
    - `ocontains` string — The field contains any of the provided values.
    - `oeq` string — The field matches any of the provided values.
    - `neq` string — The field does not match the provided value.
  - `team_id` UuidFieldFilter — Filter using **one** of the following operators: `eq`, `oeq`, `neq`
    - `eq` string — The field exactly matches the provided value.
    - `oeq` string — The field matches any of the provided values.
    - `neq` string — The field does not match the provided value.

## Response `200`

A paginated list of applications in a portal.

- ListApplicationsResponse
  - `meta` PaginatedMeta, required — returns the pagination information
    - `page` PageMeta, required — Contains pagination query parameters and the total number of objects returned.
      - `number` number, required
      - `size` number, required
      - `total` number, required
  - `data` Application[], required
    - union
      - ClientCredentialsApplication
        - `id` string, uuid, required — Contains a unique identifier used for this resource.
        - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
        - `name` string, required — The name of the application.
        - `description` string, nullable, required — A description of the application.
        - `labels` LabelsUpdate, nullable, required — Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Labels are intended to store **INTERNAL** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `client_id` string, required — The ID used to linked the portal application to an Identity Provider application.
        - `registration_count` number, required — The number of API registrations that are associated with the application. Registrations of any status are included in the count.
        - `dcr_provider` object, nullable, required — Information about the DCR provider this application uses, if using DCR.
          - `id` string, uuid, required — Contains a unique identifier used for this resource.
        - `portal` object, required — Information about the portal the application is in.
          - `id` string, uuid, required — Contains a unique identifier used for this resource.
        - `auth_strategy` AuthStrategyClientCredentials, required — Client Credential Auth strategy that the application uses.
          - `id` string, uuid, required — The Application Auth Strategy ID.
          - `name` string, required
          - `credential_type` 'client_credentials' | 'self_managed_client_credentials', required
          - `auth_methods` string[], required
          - `available_scopes` string[] — Possible developer selectable scopes for an application. Only present when using DCR Provider that supports it.
        - `granted_scopes` string[], nullable, required — List of granted scopes for the application. Null if application type does not support returning granted scopes.
        - `owner` ApplicationOwner
          - `type` 'developer' | 'team', required — The type of the owner of the application. Can be `developer` (individual developer) or `team`.
          - `id` string, uuid, required — The ID of the owner of the application. When type is `developer`, this is the developer ID. When type is `team`, this is the team ID.
      - KeyAuthApplication
        - `id` string, uuid, required — Contains a unique identifier used for this resource.
        - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
        - `name` string, required — The name of the application.
        - `description` string, nullable, required — A description of the application.
        - `auth_strategy` AuthStrategyKeyAuth, required — KeyAuth Auth strategy that the application uses.
          - `id` string, uuid, required — The Application Auth Strategy ID.
          - `name` string, required
          - `credential_type` 'key_auth', required
          - `key_names` string[], required
          - `ttl` object — Default maximum Time-To-Live for keys created under this strategy.
            - `value` integer, required
            - `unit` 'days' | 'weeks' | 'years', required
        - `portal` object, required — Information about the portal the application is in.
          - `id` string, uuid, required — Contains a unique identifier used for this resource.
        - `labels` LabelsUpdate, nullable, required — Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Labels are intended to store **INTERNAL** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `registration_count` number, required — The number of API registrations that are associated with the application. Registrations of any status are included in the count.
        - `owner` ApplicationOwner
          - `type` 'developer' | 'team', required — The type of the owner of the application. Can be `developer` (individual developer) or `team`.
          - `id` string, uuid, required — The ID of the owner of the application. When type is `developer`, this is the developer ID. When type is `team`, this is the team ID.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.net/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/0261aef4b1e2/schema)