---
title: "List Suites"
method: GET
path: "/api/v1/marketplace/suites"
tags: ["marketplace"]
---

# List Suites

`GET /api/v1/marketplace/suites`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/marketplace/suites`
- Auth: none declared

List benchmark suites with filtering and pagination.

Query parameters:
- domain: Filter by domain (code_generation, data_extraction, tool_use, customer_support, rag, research, writing, reasoning, custom)
- difficulty: Filter by difficulty (easy, medium, hard, mixed)
- search: Search in name and description
- featured_only: Only show featured suites
- sort_by: Sort by "newest", "popular" (downloads), or "rating"

## Query parameters

- `page` integer
- `page_size` integer
- `domain` string, nullable: Filter by domain
- `difficulty` string, nullable: Filter by difficulty
- `search` string, nullable: Search by name or description
- `featured_only` boolean: Show only featured suites
- `sort_by` string: Sort order: newest, popular, or rating

## Response `200`

Successful Response

- PaginatedResponseBenchmarkSuiteRead
  - `items` BenchmarkSuiteRead[], required
    - `name` string, required
    - `description` string
    - `author` string
    - `domain` 'code_generation' | 'data_extraction' | 'tool_use' | 'customer_support' | 'rag' | 'research' | 'writing' | 'reasoning' | 'custom'
    - `difficulty` string
    - `is_featured` boolean
    - `tags` string[]: List of tags
    - `id` string, uuid, required
    - `downloads` integer, required
    - `rating` number, required
    - `is_active` boolean, required
    - `task_count` integer: Number of tasks in suite
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)