---
title: "Get an API"
method: GET
path: "/v3/apis/{apiId}"
tags: ["API"]
---

# Get an API

`GET /v3/apis/{apiId}`

Get an API.

## Response `200`

API

- ApiResponseSchema
  - `id` string, uuid, required — The API identifier.
  - `name` string, required — The name of your API. The `name + version` combination must be unique for each API you publish.
  - `description` string, nullable — A description of your API. Will be visible on your live Portal.
  - `version` string, nullable, required — An optional version for your API. Leave this empty if your API is unversioned.
  - `current_version_summary` ApiVersionSummary, nullable, required
    - `id` string, uuid — The API version identifier.
    - `version` string — The version of this api spec.
    - `spec` object
      - `type` 'oas2' | 'oas3' | 'asyncapi' — The type of specification being stored. This allows us to render the specification correctly.
    - `created_at` string, date-time — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time — An ISO-8601 timestamp representation of entity update date.
  - `slug` string, nullable, required — The `slug` is used in generated URLs to provide human readable paths. Defaults to `slugify(name + version)`
  - `api_spec_ids` string[], required — The list of API specification ids for the API.
  - `portals` object[], required — The list of portals which this API is published to.
    - `id` string, uuid, required — The portal identifier.
    - `name` string, required — The name of the portal, used to distinguish it from other portals.
    - `display_name` string, required — The display name of the portal. This value will be the portal's `name` in Portal API.
  - `labels` Labels, required — Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `implementation_mode` string, nullable — the implementations that are associated with this api either gateway_entity_binding or access_control_enforcement
  - `attributes` ApiAttributes — A set of attributes that describe the API
  - `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

- `401` — ApiUnauthorized
- `403` — ApiForbidden
- `404` — Not Found

## Changes

- **2026-01-29** `48b406d912db` — 1 info
  - added the optional property `implementation_mode` to the response with the `200` status
- **2025-08-22** `3c0154b2053a` — 3 breaking
  - the response property `current_version_summary/spec` became nullable for the status `200`
  - the response property `current_version_summary/version` became nullable for the status `200`
  - the response property `name` became nullable for the status `200`
- **2025-08-14** `6333a0d3b095` — 13 info
  - removed `#/components/schemas/Api, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `attributes` to the response with the `200` status
  - added the optional property `description` to the response with the `200` status
  - added the required property `api_spec_ids` to the response with the `200` status
  - …9 more
- **2025-07-22** `76b0fefddb0d` — 10 breaking, 2 warning, 1 info
  - removed the required property `api_spec_ids` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `current_version_summary` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - …9 more
- **2025-07-01** `9a3d26a00088` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/apis/:apiId/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-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/7d3c634668f8/schema)