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

# GET /v1alpha1/apps

`GET /v1alpha1/apps`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/v1alpha1/apps`
- Auth: HTTP bearer and API key in header `x-id-api-key`

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

## Changes

> 18 revisions in range; 7 not diffed.

- **2025-08-06** `c8e7b85e5f90`: 2 info
  - added the new optional `query` request parameter `sortColumn`
  - added the new optional `query` request parameter `sortDesc`
- **2025-07-28** `63464ebf3f61`: 2 breaking, 2 warning, 6 info
  - the response property `apps/items/name` became optional for the status `200`
  - the response property `apps/items/type` became optional for the status `200`
  - deleted the `query` request parameter `sortColumn`
  - deleted the `query` request parameter `sortDesc`
  - …6 more

[Operation history](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/changes/v1alpha1/apps/get.md)

---

[API](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api.md) - [All operations](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/revisions/1dc8f8328648?raw)