---
title: "GET /v1/projects"
method: GET
path: "/v1/projects"
tags: ["projects"]
---

# GET /v1/projects

`GET /v1/projects`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects`
- Auth: HTTP bearer

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- object
  - `items` Project[], required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `name` string, required
    - `brand_name` string, required
    - `website_url` string, required
    - `industry` string, required
    - `subindustry` string, required
    - `primary_market` string, required
    - `country_code` string, required
    - `language_code` string, required
    - `benchmark_mode` 'consumer_like' | 'controlled_localized' | 'forced_grounded', required
    - `default_repetitions` integer, required
    - `brand` object, required
      - `aliases` string[], required
      - `logo_url` string, nullable
      - `matching` EntityMatching
        - `mode` 'always' | 'context_required', required
        - `context_terms` string[], required
        - `exclusion_phrases` string[], required
        - `common_word` boolean, required
    - `owned_domains` string[], required
    - `unintended_domains` string[], required
    - `competitors` Competitor[], required
      - `id` string, uuid, required
      - `name` string, required
      - `aliases` string[], required
      - `domains` string[], required
      - `logo_url` string, nullable
      - `matching` EntityMatching
        - `mode` 'always' | 'context_required', required
        - `context_terms` string[], required
        - `exclusion_phrases` string[], required
        - `common_word` boolean, required
    - `prompt_sets` PromptSet[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `name` string, required
      - `description` string
      - `prompt_count` integer
      - `prompts` Prompt[], required
        - `id` string, uuid, required
        - `prompt_set_id` string, uuid, required
        - `topic_id` string, uuid, nullable
        - `text` string, required
        - `theme` string, required
        - `intent` '' | 'discovery' | 'comparison' | 'purchase' | 'service' | 'local', required
        - `buyer_stage` '' | 'awareness' | 'consideration' | 'decision' | 'implementation', required
        - `prompt_intent` '' | 'learn' | 'solve' | 'compare' | 'recommend' | 'validate' | 'buy' | 'implement', required
        - `persona` string, required
        - `cohort` 'core' | 'brand_diagnostic' | 'comparison' | 'commerce', required
        - `branded` boolean, required
        - `enabled` boolean, required
        - `status` 'active' | 'archived', required
        - `origin` 'manual' | 'imported' | 'generated', required
        - `over_plan_limit` boolean, required
        - `created_at` string
        - `updated_at` string
      - `created_at` string, required
      - `updated_at` string, required
    - `created_at` string, required
    - `updated_at` string, required
  - `next_cursor` string, nullable, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)