---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/addons"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/addons"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/addons

`GET /v1/projects/{projectsId}/locations/{locationsId}/addons`

## Request

- Base URL: `https://apihub.googleapis.com`
- URL: `https://apihub.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/addons`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/apihub.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/apihub.readonly`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/apihub.readwrite`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/apihub.readwrite`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
- TypeScript: <https://skmtc.dev/google/apis/apihub/docs/v1/projects/:projectsId/locations/:locationsId/addons/get.ts> (a function with typed inputs; its response is checked against the schema)

List addons.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- GoogleCloudApihubV1ListAddonsResponse: The ListAddons method's response.
  - `addons` GoogleCloudApihubV1Addon[]: The list of addons.
    - `boostSpecGeminiRegionId` string: Output only. The Vertex AI region where the BoostSpec Gemini model calls run for this API Hub instance. Populated only for the SpecGen addon (`system-spec-generation`); other addons leave this field empty. `gemini-2.5-flash` is not available in every API Hub region, so the effective region may differ from the API Hub instance's own region. The value follows these semantics: - `""`: BoostSpec is disabled in this region (the addon is not SpecGen, or the API Hub instance region has no configured Gemini endpoint or fallback). - Equal to the API Hub instance region: BoostSpec calls run in-region. - Differs from the API Hub instance region: BoostSpec calls run in the specified fallback region. Callers rendering this field can derive the three display states from this single field combined with the API Hub instance region.
    - `config` GoogleCloudApihubV1AddonConfig: Configuration for the addon.
      - `allDataAddonConfig` GoogleCloudApihubV1AllDataAddonConfig: Configuration for addons which act on all data in the API hub. This is used to specify if the addon is enabled for all data in the API hub.
        - `enabled` boolean: Required. If true, the addon is enabled for all data in the API hub.
      - `gatewayPluginAddonConfig` GoogleCloudApihubV1GatewayPluginAddonConfig: Configuration for gateway plugin addons. This is used to specify the list of gateway plugin configs for which the addon is enabled.
        - `gatewayPluginConfigs` GoogleCloudApihubV1GatewayPluginConfig[]: Required. The list of gateway plugin configs for which the addon is enabled. Each gateway plugin config should have a unique plugin instance.
          - `apigeeEdgeConfig` GoogleCloudApihubV1ApigeeEdgeConfig: Configuration for Apigee Edge gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
            - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
              - …
          - `apigeeOpdkConfig` GoogleCloudApihubV1ApigeeOPDKConfig: Configuration for Apigee OPDK gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
            - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
              - …
          - `apigeeXHybridConfig` GoogleCloudApihubV1ApigeeXHybridConfig: Configuration for Apigee X and Apigee Hybrid gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
            - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
              - …
          - `pluginInstance` string: Required. The name of the gateway plugin instance for which the config is to be specified. Format: projects/{project}/locations/{location}/plugins/{plugin}/pluginInstances/{plugin_instance}
    - `createTime` string, google-datetime: Output only. The time at which the addon was created.
    - `dataSource` 'DATA_SOURCE_UNSPECIFIED' | 'PLUGIN_INSTANCE' | 'ALL_DATA': Required. The data source on which the addon operates. This determines which field in the `config` oneof is used.
    - `description` string: Optional. The description of the addon.
    - `displayName` string: Required. The display name of the addon.
    - `name` string: Identifier. The name of the addon to enable. Format: `projects/{project}/locations/{location}/addons/{addon}`.
    - `state` 'ADDON_STATE_UNSPECIFIED' | 'ACTIVE' | 'UPDATING' | 'ERROR' | 'INACTIVE': Output only. The state of the addon.
    - `updateTime` string, google-datetime: Output only. The time at which the addon was last updated.
  - `nextPageToken` string: A token to retrieve the next page of results, or empty if there are no more results in the list.

## Changes

- **2026-11-08** `09b6c7d2247b`: 4 info
  - the security scope `https://www.googleapis.com/auth/apihub.readonly` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/apihub.readonly` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/apihub/changes/v1/projects/:projectsId/locations/:locationsId/addons/get.md)

---

[API](https://skmtc.dev/google/apis/apihub.md) - [All operations](https://skmtc.dev/google/apis/apihub/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/apihub/revisions/09b6c7d2247b?raw)