---
title: "List creator spaces"
method: GET
path: "/creator-spaces"
---

# List creator spaces

`GET /creator-spaces`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/creator-spaces`
- Auth: HTTP bearer

Lists only creator spaces authorized through the caller's effective memberships. Use detail=summary for compact discovery. Omitting detail preserves the legacy full public projection.

## Query parameters

- `detail` 'summary' | 'full'
- `limit` integer
- `cursor` string
- `offset` integer

## Response `200`

Creator spaces

- CreatorSpacesResponse
  - `data` CreatorSpace[]
    - `id` string
    - `creator_id` string: Alias of id for agent workflows that ask for creator_id.
    - `user_id` string, nullable
    - `workspace_id` string, nullable
    - `name` string, nullable
    - `bio` string, nullable
    - `industry` string, nullable
    - `job_description` string, nullable
    - `avatar_url` string, nullable
    - `linkedin_username` string, nullable
    - `linkedin_headline` string, nullable
    - `linkedin_profile_url` string, nullable
    - `website_url` string, nullable
    - `website_summary` string, nullable
    - `follower_count` integer, nullable: Current LinkedIn follower count from the linked profile metrics row.
    - `connection_count` integer, nullable
    - `profile_views` integer, nullable
    - `linkedin_profile` LinkedInCreatorProfile, nullable
      - `id` string
      - `url` string, nullable
      - `name` string, nullable
      - `headline` string, nullable
      - `bio` string, nullable
      - `job_title` string, nullable
      - `company_name` string, nullable
      - `location` string, nullable
      - `profile_image_url` string, nullable
      - `follower_count` integer, nullable
      - `connection_count` integer, nullable
      - `profile_views` integer, nullable
      - `status` string, nullable
      - `last_refreshed` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `pagination` object
    - `limit` integer, required
    - `offset` integer, required: Legacy numeric position. New callers should use next_cursor.
    - `returned` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null on the final page.

## Other responses

- `400`: Invalid cursor

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)