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

# GET /v1/projects/{projectsId}/locations/{locationsId}/apiHubInstances:lookup

`GET /v1/projects/{projectsId}/locations/{locationsId}/apiHubInstances:lookup`

## Request

- Base URL: `https://apihub.googleapis.com`
- URL: `https://apihub.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/apiHubInstances:lookup`
- 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/apiHubInstances:lookup/get.ts> (a function with typed inputs; its response is checked against the schema)

Looks up an Api Hub instance in a given Google Cloud project. There will always be only one Api Hub instance for a Google Cloud project across all locations.

## Path parameters

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

## Response `200`

Successful response

- GoogleCloudApihubV1LookupApiHubInstanceResponse: The LookupApiHubInstance method's response.`
  - `apiHubInstance` GoogleCloudApihubV1ApiHubInstance: An ApiHubInstance represents the instance resources of the API Hub. Currently, only one ApiHub instance is allowed for each project.
    - `config` GoogleCloudApihubV1Config: Available configurations to provision an ApiHub Instance.
      - `agentRegistrySyncConfig` GoogleCloudApihubV1AgentRegistrySyncConfig: The configuration for Agent Registry sync.
        - `disabled` boolean: Optional. If true, the MCP data sync to the Agent Registry will be disabled. The default value is false.
      - `cmekKeyName` string: Optional. The Customer Managed Encryption Key (CMEK) used for data encryption. The CMEK name should follow the format of `projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+)`, where the location must match the instance location. If the CMEK is not provided, a GMEK will be created for the instance.
      - `disableSearch` boolean: Optional. If true, the search will be disabled for the instance. The default value is false.
      - `encryptionType` 'ENCRYPTION_TYPE_UNSPECIFIED' | 'GMEK' | 'CMEK': Optional. Encryption type for the region. If the encryption type is CMEK, the cmek_key_name must be provided. If no encryption type is provided, GMEK will be used.
      - `vertexLocation` string: Optional. The name of the Vertex AI location where the data store is stored.
    - `createTime` string, google-datetime: Output only. Creation timestamp.
    - `description` string: Optional. Description of the ApiHub instance.
    - `labels` object: Optional. Instance labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources
    - `name` string: Identifier. Format: `projects/{project}/locations/{location}/apiHubInstances/{apiHubInstance}`.
    - `state` 'STATE_UNSPECIFIED' | 'INACTIVE' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'FAILED': Output only. The current state of the ApiHub instance.
    - `stateMessage` string: Output only. Extra information about ApiHub instance state. Currently the message would be populated when state is `FAILED`.
    - `updateTime` string, google-datetime: Output only. Last update timestamp.

## 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/apiHubInstances:lookup/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)