---
title: "Get an Application by Portal"
method: GET
path: "/v3/portals/{portalId}/applications/{applicationId}"
tags: ["Applications"]
---

# Get an Application by Portal

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

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/portals/{portalId}/applications/{applicationId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Returns the configuration of a single application in this portal. If an application is linked to a DCR Provider, the `dcr_provider.id` and `client_id` can be used to correlate it. An application manages a set of credentials and registrations for specific APIs.

## Response `200`

Details about an application in a portal.

- 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

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-09-25** `68d43091b84d`: 2 warning
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4`: 2 breaking, 17 info
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - …15 more
- **2025-08-22** `3c0154b2053a`: 4 breaking
  - the response property `detail` became nullable for the status `401`
  - the response property `instance` became nullable for the status `401`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
- **2025-07-01** `9a3d26a00088`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/:portalId/applications/:applicationId/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)