---
title: "List Portal API Publications"
method: GET
path: "/v3/portals/{portalId}/api-publications"
tags: ["API Publication"]
---

# List Portal API Publications

`GET /v3/portals/{portalId}/api-publications`

## Request

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

Returns a collection of all API Publications for a specific portal.

**Access Control**: Requires permission to view the specified portal. Once portal access is granted, all API publications for that portal are returned regardless of the caller's individual API permissions.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter` PortalApiPublicationFilterParameters: API Publication filters excluding portal-specific fields (since portal is already specified in path)
  - `api_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.
  - `api_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.
  - `auth_strategy_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.
  - `entity_type` 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.
- `sort` string: The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order. Multiple sort attributes may be provided via a comma separated list. JSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc').

## Response `200`

Paginated list of publications

- object
  - `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` PublicationListItem[], required
    - `api_id` string, uuid, required: The API identifier.
    - `portal_ids` string[], required: The portal identifier.
    - `auto_approve_registrations` boolean, required: Whether the application registration auto approval on this portal for the api is enabled. If set to false, fallbacks on portal's auto_approve_applications value.
    - `entity_type` 'api' | 'api_package', required: The type of entity that is being published. Can be either an API or an API Package.
    - `visibility` 'public' | 'private', required: The visibility of the API in the portal. Public API publications do not require authentication to view and retrieve information about them. Private API publications require authentication to retrieve information about them. If omitted, this defaults to the target portal's configured default API visibility.
    - `auth_strategy_ids` string[], nullable, required: The auth strategy the API enforces for applications in the portal. Omitting this property means the portal's default application auth strategy will be used. Setting to null means the API will not require application authentication. DCR support for application registration is currently in development.
    - `spec_renderer` object, nullable, required: Customization settings for the API spec renderer in the portal.
      - `try_it_ui` boolean, nullable, required: Enable in-browser testing for your API. All linked gateways must have the CORS plugin configured.
      - `try_it_ui_audience` 'all' | 'authenticated' | 'registered', nullable, required: The audience for the Try It UI feature. `all` means that the Try It UI will be available to all users, including unauthenticated users. `authenticated` means that the Try It UI will only be available to authenticated users. `registered` means that the Try It UI will only be available to users who have registered for the API.
    - `form_id` string, uuid, nullable, required: UUID of portal form associated with API publication, must be linked to given portal and have type of 'api_registration'
    - `warnings` string[]: Informational warnings (e.g. incompatible fields stripped for ACE). Empty if none.
    - `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.

## Other responses

- `400`: Bad Request
- `401`: ApiUnauthorized
- `403`: ApiForbidden
- `404`: Not Found

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning, 1 info
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the required property `data/items/spec_renderer` to the response with the `200` status
- **2026-09-25** `68d43091b84d`: 4 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `401.00` enum value to the `status` response property for the response status `401`
  - 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`
- …earlier changes not shown

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/:portalId/api-publications/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)