---
title: "List SFX categories"
method: GET
path: "/v0/sound-effects/categories"
tags: ["Sound effects"]
---

# List SFX categories

`GET /v0/sound-effects/categories`

The sound effects categories endpoint allows you to get a list of all sound effects categories.

You can then browse the sound effects catalog based on categories like "Applause" or "Crowds".

Some sound effect categories have cover art that you can use in your interface. You can choose to display all categories, or choose type "featured" to only show the categories that are chosen by our curation team.

## Query parameters

- `type` 'all' | 'featured'
- `offset` integer

## Response `200`

Sound effects category list with related parent category. You can see the parent-child relationship in the response.

- SoundEffectCategoriesResponse
  - `categories` SoundEffectCategoryWithParentResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `images` ImagesResponse
      - `default` string, nullable
      - `M` string, nullable
      - `L` string, nullable
      - `S` string, nullable
      - `XS` string, nullable
    - `parent` RelatedSoundEffectCategoryResponse
      - `id` string, uuid, required
      - `name` string, required
  - `pagination` Pagination, required
    - `page` integer, required
    - `limit` integer, required
    - `offset` integer
  - `links` PaginationLinks, required
    - `next` string, nullable
    - `prev` string, nullable

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.dev/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/c148308a0ed4/schema)