---
title: "Get all campaigns for a user"
method: GET
path: "/api/v2/campaigns"
tags: ["Campaigns"]
---

# Get all campaigns for a user

`GET /api/v2/campaigns`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/v2/campaigns`
- Auth: HTTP bearer

Retrieve all campaigns for a given user_id, grouped by created_by, and return all campaign records with full attributes.

## Query parameters

- `user_id` string, required

## Response `200`

List of campaigns for the user

- object
  - `status` string
  - `campaigns` Campaign[]
    - `id` string
    - `created_by` string
    - `name` string
    - `target_age` object
    - `target_gender` object
    - `region` object
    - `goal` string, nullable
    - `description` string, nullable
    - `created_at` string
    - `updated_at` string
    - `status` string, nullable
    - `target_user_tags` object
    - `job_detail` object, nullable
    - `terms` object
    - `product_link` string
    - `priority` number
    - `campaign_mode` string
    - `required_cpm` number, nullable
    - `outreach_language` string
    - `search_requirement` object
    - `email_signature` string, nullable
    - `campaign_data` object
    - `sample_required` boolean
    - `channels` object
    - `g_reach` number, nullable
    - `g_engagement_rate` number, nullable
    - `g_deep_engagement_rate` number, nullable
    - `generate_status` boolean
    - `deadline` string, nullable
    - `content_type` string
    - `Inf_Desired_Qualities` object, nullable
    - `brief_link` string, nullable
    - `email_weight` number, nullable
    - `mid_views_requirement` number, nullable
    - `accept_new` boolean, nullable
    - `confirm_collab_deadline` string, nullable
    - `content_finish_deadline` string, nullable
    - `publish_deadline` string, nullable
    - `scheduled_publish_date` string, nullable
    - `content_ownership` string
    - `whitelisted_ads_allowed` boolean
    - `content_reuse_rights` boolean
    - `authorization_period` string
    - `third_party_authorization` boolean
    - `exclusivity_required` boolean
    - `min_retention_period` string
    - `ad_disclosure_required` boolean
    - `hashtag_requirements` string
    - `official_account_mention` boolean
    - `link_in_bio_required` boolean
    - `link_in_comments_required` boolean
    - `content_preapproval_required` boolean
    - `max_revision_count` number
    - `data_report_required` boolean
    - `communication_methods` string[], nullable
    - `industry` string, nullable
    - `influencer_examples` string[], nullable
    - `contact_methods` string, nullable
    - `media_assets_url` string[], nullable
    - `campaign_total_budget` number, nullable
  - `count` integer: Number of campaigns returned
  - `timestamp` string, date-time: ISO timestamp of when the request was processed

## Other responses

- `400`: Missing or invalid user_id
- `500`: Internal server error

---

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