---
title: "List Apis"
method: GET
path: "/apis"
tags: ["APIs"]
---

# List Apis

`GET /apis`

List locally registered APIs with optional vendor filter and pagination.

This is the **imported** registry — APIs present in this deployment. The
public catalog of importable-but-not-yet-imported APIs is a separate surface
(``GET /catalog``); the two are not blended.

## Query parameters

- `vendor` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ApiListResponse — Cursor-paginated list of APIs.
  - `data` ApiResponse[], required
    - `_links` ApiLinksResponse, required — Hypermedia links for a (local) API resource.
      - `current_revision` string, nullable
      - `revisions` string, required
      - `self` string, required
    - `api` ApiReferenceResponse, required — Core API identifier triple plus derived host.
      - `host` string, nullable, required
      - `name` string, required
      - `vendor` string, required
      - `version` string, required
    - `created_at` string, date-time, required
    - `current_revision_id` string, nullable, required
    - `description` string, nullable, required
    - `display_name` string, nullable, required
    - `icon_url` string, nullable, required
    - `operation_count` integer, required
    - `revision_count` integer, required
    - `security_schemes` string[], required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-07-01** `d65fcba0d25a` — 8 breaking, 9 warning, 32 info
  - for the `query` request parameter `limit`, default value was changed from `20` to `50`
  - response property `data/items/created_at` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - removed the required property `data/items/id` from the response with the `200` status
  - …45 more
- **2026-06-16** `ba15fae43892` — 2 info
  - added the optional property `data/items/local` to the response with the `200` status
  - added the optional property `data/items/source` to the response with the `200` status
- **2026-05-29** `2f5d07712937` — 1 info
  - added the new optional `query` request parameter `include_imported`
- **2026-04-13** `76e8f6063728` — 18 breaking, 9 warning, 20 info
  - for the `query` request parameter `limit`, default value was changed from `50` to `20`
  - for the `query` request parameter `limit`, the max was decreased from `200.00` to `100.00`
  - media type `application/problem+json` was changed to a more general media type `application/json` for the response status `422`
  - the response property `data/items/created_at` became optional for the status `200`
  - …43 more

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/apis/get.md)

---

[API](https://skmtc.dev/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.dev/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jentic/apis/jentic-control-plane-api/revisions/16dd484920cc?raw)
