---
title: "List collections"
method: GET
path: "/collections"
tags: ["Collections"]
---

# List collections

`GET /collections`

## Request

- Base URL: `https://studio.fintechstudios.com/api/v1`
- URL: `https://studio.fintechstudios.com/api/v1/collections`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

List the authenticated user's collections. Only returns channel-type collections (not legacy saved searches).

## Query parameters

- `page` integer
- `per_page` integer
- `type` 'news' | 'stock_portfolio' | 'regulatory'
- `is_active` boolean

## Response `200`

Paginated collections list

- object
  - `data` CollectionListItem[]
    - `id` string
    - `name` string
    - `description` string, nullable
    - `type` 'news' | 'stock_portfolio' | 'regulatory' | 'crypto' | 'prediction_markets'
    - `source_count` integer
    - `sources` string[]: Provider IDs
    - `is_active` boolean
    - `last_executed_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` object
    - `request_id` string
    - `credits_used` integer
    - `credits_remaining` integer
    - `rate_limit` object
      - `limit` integer
      - `remaining` integer
      - `reset` integer
    - `total` integer
    - `page` integer
    - `per_page` integer
    - `has_more` boolean

---

[API](https://skmtc.dev/fintechstudios/apis/fts-studio-api.md) · [All operations](https://skmtc.dev/fintechstudios/apis/fts-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintechstudios/apis/fts-studio-api/revisions/4886597d1d96?raw)