> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Campaigns

> Retrieves a list of all available campaigns for your organization

Retrieves a list of all available campaigns for your organization. This endpoint returns basic campaign information including campaign IDs, names, types, and statuses that can be used for filtering and organization purposes.

## Request Parameters

This endpoint does not require any specific parameters, but standard authentication is required.

| Parameter | Type | Description                                         | Required |
| --------- | ---- | --------------------------------------------------- | -------- |
| None      | -    | This endpoint does not accept additional parameters | -        |

## Request Example

```bash theme={null}
curl -X GET "https://api.growi.io/api/public/v1/organizations/campaigns" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

## Response Example

```json theme={null}
{
  "success": true,
  "campaigns": [
    {
      "id": 16425,
      "name": "Campaign Name",
      "campaign_type": "Campaign",
      "status": "Active"
    },
    {
      "id": 16426,
      "name": "Summer Collection 2024",
      "campaign_type": "Contract",
      "status": "Paused"
    },
    {
      "id": 16427,
      "name": "Brand Ambassador Program",
      "campaign_type": "Ambassador Program",
      "status": "Active"
    }
  ]
}
```

## Response Fields

| Field                       | Type    | Description                                                                          |
| --------------------------- | ------- | ------------------------------------------------------------------------------------ |
| `success`                   | Boolean | Indicates whether the request was successful                                         |
| `campaigns`                 | Array   | Array of campaign objects                                                            |
| `campaigns[].id`            | Integer | Unique identifier for the campaign                                                   |
| `campaigns[].name`          | String  | Display name of the campaign                                                         |
| `campaigns[].campaign_type` | String  | Type of campaign (Campaign, Contract, Ambassador Program)                            |
| `campaigns[].status`        | String  | Current status of the campaign (Active, Paused, Canceled, Completed, Archived, Void) |

## Use Cases

* **Campaign Filtering**: Use campaign IDs to filter data in other API endpoints
* **Campaign Management**: Retrieve available campaigns for management interfaces
* **Organization Setup**: Get campaign information for initial application setup
* **Reporting**: Include campaign names and statuses in reports and analytics dashboards
* **Status Monitoring**: Track campaign statuses across your organization

## Error Responses

```json theme={null}
{
  "error": "Not Authenticated"
}
```

Common error scenarios:

* **401 Unauthorized**: Invalid or missing Bearer token
* **403 Forbidden**: API key doesn't have permission to access campaigns
* **422 Unprocessable Entity**: Organization not found
* **500 Internal Server Error**: Server-side error occurred


## OpenAPI

````yaml GET /organizations/campaigns
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /organizations/campaigns:
    get:
      description: Retrieves a list of all available campaigns for your organization
      responses:
        '200':
          description: Get your campaigns information
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  campaigns:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 16425
                          description: Unique identifier for the campaign
                        name:
                          type: string
                          example: Campaign Name
                          description: Display name of the campaign
                        campaign_type:
                          type: string
                          example: Campaign
                          enum:
                            - Campaign
                            - Contract
                            - Ambassador Program
                          description: Type of campaign
                        status:
                          type: string
                          example: Active
                          enum:
                            - Active
                            - Paused
                            - Canceled
                            - Completed
                            - Archived
                            - Void
                          description: Current status of the campaign
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Organization not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Organization not found
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````