---
title: "List all categories"
method: GET
path: "/v1/categories"
tags: ["Categories"]
---

# List all categories

`GET /v1/categories`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/v1/categories`
- Auth: none declared

Returns all active categories with API counts, tags, trending status, descriptions, and image URLs.

## Response `200`

Category list

- V1CategoriesResponse
  - `data` CategoryDetail[]
    - `id` string: Category slug (used as ID)
    - `name` string: Display name
    - `description` string: Category description
    - `imageUrl` string, uri, nullable: Banner/image URL
    - `apiCount` integer: Number of published APIs in this category
    - `tags` string[]: Searchable tags
    - `isTrending` boolean: Whether this category is currently trending

## Changes

- **2026-10-20** `7f07b9ca718f`: 1 warning, 1 info
  - removed the optional property `categories` from the response with the `200` status
  - added the optional property `data` to the response with the `200` status

[Operation history](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/changes/v1/categories/get.md)

---

[API](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api.md) · [All operations](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/revisions/7f07b9ca718f?raw)