---
title: "Retrieve campaigns"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-campaigns-api-1/versions/e0ad0bb4-8312-4ba5-bc53-d0218db2d92e/paths/api-workflow-campaigns/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/workflow-campaigns-api-1/versions/e0ad0bb4-8312-4ba5-bc53-d0218db2d92e.md

# Retrieve campaigns

`GET` `/api/workflow/campaigns`

Requires the CAMPAIGNOVERVIEW security role.

## Responses

- `200` - Successfully retrieved campaigns

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Workflow Campaigns API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/workflow/campaigns:
    get:
      description: Requires the CAMPAIGNOVERVIEW security role.
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  properties:
                    ID:
                      example: 00000000-0000-0000-0000-000000000000
                      type: string
                    accountID:
                      example: 00000000-0000-0000-0000-000000000000
                      type: string
                    campaignMetaproperties:
                      additionalProperties:
                        example: 00000000-0000-0000-0000-000000000000
                        type: string
                      type: object
                    closed:
                      example: false
                      type: boolean
                    createdByID:
                      example: 00000000-0000-0000-0000-000000000000
                      type: string
                    dateCreated:
                      example: 2017-01-10T07:43:12+00:00
                      format: date-time
                      type: string
                    dateModified:
                      example: 2017-01-10T07:43:12+00:00
                      format: date-time
                      type: string
                    dateStart:
                      example: 2017-02-01T00:00:00+00:00
                      format: date-time
                      type: string
                    deadline:
                      example: 2017-03-03T00:00:00
                      format: date
                      type: string
                    description:
                      example: Campaign example
                      type: string
                    key:
                      example: excp
                      type: string
                    name:
                      example: Example campaign
                      type: string
                    presetID:
                      example: 00000000-0000-0000-0000-000000000000
                      type: string
                    responsibleID:
                      example: 00000000-0000-0000-0000-000000000000
                      type: string
                    thumbnailURL:
                      example: https://bynder-public-eu-central-1.s3.eu-central-1.amazonaws.com:443/workflow/campaign/988BBB04-F0E2-4A28-B5F892890849BAFE/FEE78434-649A-449B-A62A1C6C6D59CAC3/500x500.jpg
                      type: string
                  type: object
                type: array
          description: Successfully retrieved campaigns
      security:
        - OAuth2:
            - CAMPAIGNOVERVIEW
        - permanentToken:
            - CAMPAIGNOVERVIEW
      summary: Retrieve campaigns
      tags:
        - Campaigns
security:
  - OAuth2:
      - CAMPAIGNOVERVIEW
  - permanentToken:
      - CAMPAIGNOVERVIEW
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            CAMPAIGNADD: ""
            CAMPAIGNEDIT: ""
            CAMPAIGNOVERVIEW: ""
            CAMPAIGNREMOVE: ""
            CAMPAIGNWRITE: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            CAMPAIGNADD: ""
            CAMPAIGNEDIT: ""
            CAMPAIGNOVERVIEW: ""
            CAMPAIGNREMOVE: ""
            CAMPAIGNWRITE: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```