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

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

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

## Request

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

Lists the APIs the pipeline is tracking, ordered by `update_time desc`. Preview: this method is in Public Preview. Behavior and the API surface may change until the Spec Generation feature reaches General Availability.

## Path parameters

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

## Query parameters

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

## Response `200`

Successful response

- GoogleCloudApihubV1ListGeneratedSpecApisResponse: Response for ListGeneratedSpecApis.
  - `generatedSpecApis` GoogleCloudApihubV1GeneratedSpecApi[]: The tracked APIs for the requested parent, ordered by `update_time desc`.
    - `api` string: Output only. The full resource name of the associated catalog API. Format: `projects/{project}/locations/{location}/apis/{api}`
    - `createTime` string, google-datetime: Output only. The time at which the resource was created.
    - `deployment` string: Output only. The full resource name of the associated catalog Deployment. Format: `projects/{project}/locations/{location}/deployments/{deployment}`
    - `displayName` string: Output only. Human-readable display name; server-derived.
    - `lastSpecGeneratedTime` string, google-datetime: Output only. The time at which the most recent spec was generated. Unset while `state == SPEC_API_REGISTERED`.
    - `name` string: Identifier. The full resource name. The trailing segment is the pipeline-generated identifier. Format: `projects/{project}/locations/{location}/generatedSpecApis/{generated_spec_api}`
    - `source` GoogleCloudApihubV1GeneratedSpecApiSource: User-facing collapse of the source-side identity tuple.
      - `sourceDisplayName` string: Output only. Per-source instance label (e.g. "/" for Apigee X).
      - `type` 'TYPE_UNSPECIFIED' | 'APIGEE_X': Output only. The source type.
      - `typeDisplayName` string: Output only. Server-supplied label (e.g. "Apigee X").
    - `spec` string: Output only. The full resource name of the associated catalog Spec; populated only when `state == SPEC_ASSOCIATED`. Format: `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
    - `state` 'STATE_UNSPECIFIED' | 'SPEC_API_REGISTERED' | 'SPEC_GENERATED' | 'SPEC_ASSOCIATED': Output only. The current lifecycle state.
    - `updateTime` string, google-datetime: Output only. The time at which the resource was last updated.
    - `version` string: Output only. The full resource name of the associated catalog Version. Format: `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
  - `nextPageToken` string: A token to retrieve the next page of results; empty when there are no more results.

## Changes

- **2026-11-08** `09b6c7d2247b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/apihub/changes/v1/projects/:projectsId/locations/:locationsId/generatedSpecApis/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)
