---
title: "GET /v1alpha1/apps"
method: GET
path: "/v1alpha1/apps"
tags: ["AppService"]
---

# GET /v1alpha1/apps

`GET /v1alpha1/apps`

List Apps.

## Query parameters

- `page` integer
- `size` integer
- `query` string
- `types` string[]
- `sortColumn` string
- `sortDesc` boolean

## Response `200`

OK

- ListAppsResponse
  - `apps` App[] — A list of Apps.
    - `id` string — A unique identifier for the App.
    - `name` string, required — A human-readable name for the App.
    - `description` string — A human-readable description for the App.
    - `type` 'APP_TYPE_UNSPECIFIED' | 'APP_TYPE_AGENT_A2A' | 'APP_TYPE_AGENT_OASF' | 'APP_TYPE_MCP_SERVER', enum, required — The type of the App.
    - `resolverMetadataId` string — The DID value
    - `apiKey` string — The API Key Secret for the App.
    - `status` 'APP_STATUS_UNSPECIFIED' | 'APP_STATUS_ACTIVE' | 'APP_STATUS_PENDING' | 'APP_STATUS_REVOKED', enum — The status of the App
    - `createdAt` string, date-time — CreatedAt records the timestamp of when the App was initially created
  - `pagination` PagedResponse — Pagination response
    - `nextPage` integer — Next page
    - `hasNextPage` boolean — Has next page
    - `total` string — The total size of items
    - `size` integer — The size of the current page

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/agntcy/apis/agntcy-identity-service-api.md) · [All operations](https://skmtc.net/agntcy/apis/agntcy-identity-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agntcy/agntcy-identity-service-api/revisions/1dc8f8328648/schema)