---
title: "Retrieve the jobs of a specific campaign"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-jobs-api-1/versions/fe891cd9-8e8e-454e-83d7-5e79bbd56714/paths/api-workflow-campaigns-id--jobs/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/workflow-jobs-api-1/versions/fe891cd9-8e8e-454e-83d7-5e79bbd56714.md

# Retrieve the jobs of a specific campaign

`GET` `/api/workflow/campaigns/{id}/jobs`

Requires the CAMPAIGNOVERVIEW security role.

## Path parameters

- `id` (string, required)

## Query parameters

- `dateCreatedFrom` (string, date-time, optional)
- `dateCreatedTo` (string, date-time, optional)
- `dateModifiedFrom` (string, date-time, optional)
- `dateModifiedTo` (string, date-time, optional)
- `deadlineFrom` (string, date-time, optional)
- `deadlineTo` (string, date-time, optional)
- `resonsibleIDs` (string, optional)
- `accountableIDs` (string, optional)
- `status` (string, optional)
- `orderBy` (string, optional)
- `limit` (integer, optional)
- `page` (integer, optional)

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Workflow Jobs API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/workflow/campaigns/{id}/jobs:
    get:
      description: Requires the CAMPAIGNOVERVIEW security role.
      parameters:
        - example: 00000000-0000-0000-0000-000000000000
          in: path
          name: id
          required: true
          schema:
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: dateCreatedFrom
          schema:
            description: Retrieve jobs created after this date. ISO8601 format
              yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: dateCreatedTo
          schema:
            description: Set a date range together with the "dateCreated" parameter. ISO8601
              format yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: dateModifiedFrom
          schema:
            description: Retrieve jobs modified after this date. ISO8601 format
              yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: dateModifiedTo
          schema:
            description: Set a date range together with the "dateModified" parameter.
              ISO8601 format yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: deadlineFrom
          schema:
            description: Retrieve jobs with a deadline after this date. ISO8601 format
              yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 2020-01-01T12:00:00Z
          in: query
          name: deadlineTo
          schema:
            description: Retrieve jobs with a deadline before this date. ISO8601 format
              yyyy-mm-ddThh:mm:ssZ.
            format: date-time
            type: string
        - example: 00000000000000000000000000000000,00000000000000000000000000000000
          in: query
          name: resonsibleIDs
          schema:
            type: string
        - example: 00000000000000000000000000000000,00000000000000000000000000000000
          in: query
          name: accountableIDs
          schema:
            type: string
        - example: Approved,NeedsChanges
          in: query
          name: status
          schema:
            type: string
        - example: dateModified desc
          in: query
          name: orderBy
          schema:
            type: string
        - example: 100
          in: query
          name: limit
          schema:
            type: integer
        - example: 1
          in: query
          name: page
          schema:
            type: integer
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    - accountableID: 00000000-0000-0000-0000-000000000000
                      basedOnPreset: false
                      campaignID: 00000000-0000-0000-0000-000000000000
                      createdByID: 00000000-0000-0000-0000-000000000000
                      dateCreated: 2017-03-30T11:42:30+00:00
                      dateFinished: 2021-02-25T16:19:42+00:00
                      dateModified: 2017-03-30T11:43:19+00:00
                      deadline: null
                      description: ""
                      id: 00000000-0000-0000-0000-000000000000
                      jobFinishedHistory:
                        - date: 2021-02-24T16:23:48+00:00
                          userId: 00000000-0000-0000-0000-000000000000
                        - date: 2021-02-25T16:19:42+00:00
                          userId: 00000000-0000-0000-0000-000000000000
                      jobKey: 0000-0
                      jobMetaproperties:
                        00000000-0000-0000-0000-000000000001: 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000
                        00000000-0000-0000-0000-000000000002: Country
                        00000000-0000-0000-0000-000000000003: City
                      job_active_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 2
                        status: Active
                      job_next_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 3
                        status: Idle
                      job_previous_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 1
                        status: Approved
                      job_stages:
                        - id: 00000000-0000-0000-0000-000000000000
                          position: 1
                          status: Approved
                        - id: 00000000-0000-0000-0000-000000000000
                          position: 2
                          status: Active
                        - id: 00000000-0000-0000-0000-000000000000
                          position: 3
                          status: Idle
                      name: Test API
                      presetID: null
                    - accountableID: 00000000-0000-0000-0000-000000000000
                      basedOnPreset: false
                      bookedMinutes: 10
                      campaignID: 00000000-0000-0000-0000-000000000000
                      createdByID: 00000000-0000-0000-0000-000000000000
                      dateCreated: 2017-03-30T11:42:30+00:00
                      dateFinished: null
                      dateModified: 2017-03-30T11:43:19+00:00
                      deadline: null
                      description: ""
                      id: 00000000-0000-0000-0000-000000000000
                      jobFinishedHistory: null
                      jobKey: 0000-0
                      jobMetaproperties:
                        00000000-0000-0000-0000-000000000001: 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000
                        00000000-0000-0000-0000-000000000002: Country
                        00000000-0000-0000-0000-000000000003: City
                      job_active_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 2
                        status: Active
                      job_next_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 3
                        status: Idle
                      job_previous_stage:
                        id: 00000000-0000-0000-0000-000000000000
                        position: 1
                        status: Approved
                      job_stages:
                        - id: 00000000-0000-0000-0000-000000000000
                          position: 1
                          status: Approved
                        - id: 00000000-0000-0000-0000-000000000000
                          position: 2
                          status: Active
                        - bookedMinutes: 5
                          id: 00000000-0000-0000-0000-000000000000
                          position: 3
                          status: Idle
                      name: Test API with booked time
                      presetID: null
              schema:
                items:
                  properties:
                    accountableID:
                      type: string
                    basedOnPreset:
                      type: string
                    bookedMinutes:
                      type: number
                    campaignID:
                      type: string
                    createdByID:
                      type: string
                    dateCreated:
                      type: string
                    dateFinished:
                      type: string
                    dateModified:
                      type: string
                    deadline:
                      type: string
                    description:
                      type: string
                    id:
                      type: string
                    jobFinishedHistory:
                      items:
                        properties:
                          date:
                            type: string
                          userId:
                            type: string
                        type: object
                      type: array
                    jobKey:
                      type: string
                    jobMetaproperties:
                      additionalProperties:
                        type: string
                      type: object
                    job_active_stage:
                      properties:
                        id:
                          type: string
                        position:
                          type: string
                        status:
                          type: string
                      type: object
                    job_next_stage:
                      properties:
                        id:
                          type: string
                        position:
                          type: string
                        status:
                          type: string
                      type: object
                    job_previous_stage:
                      properties:
                        id:
                          type: string
                        position:
                          type: string
                        status:
                          type: string
                      type: object
                    job_stages:
                      items:
                        properties:
                          id:
                            type: string
                          position:
                            type: string
                          status:
                            type: string
                        type: object
                      type: array
                    name:
                      type: string
                    presetID:
                      type: string
                  type: object
                type: array
          description: Successful response
          headers:
            X-Pagination-Limit:
              example: 100
              schema:
                type: integer
            X-Pagination-Page:
              example: 2
              schema:
                type: integer
            X-Pagination-TotalPages:
              example: 100
              schema:
                type: integer
            X-Pagination-TotalRecords:
              example: 10000
              schema:
                type: integer
      security:
        - permanentToken:
            - CAMPAIGNOVERVIEW
        - OAuth2:
            - CAMPAIGNOVERVIEW
      summary: Retrieve the jobs of a specific campaign
      tags:
        - Campaign jobs
security:
  - permanentToken:
      - CAMPAIGNOVERVIEW
  - OAuth2:
      - CAMPAIGNOVERVIEW
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            CAMPAIGNOVERVIEW: ""
            JOBADD: ""
            JOBAPPROVE: ""
            JOBEDIT: ""
            JOBOVERVIEW: ""
            JOBREMOVE: ""
            PRESETOVERVIEW: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            CAMPAIGNOVERVIEW: ""
            JOBADD: ""
            JOBAPPROVE: ""
            JOBEDIT: ""
            JOBOVERVIEW: ""
            JOBREMOVE: ""
            PRESETOVERVIEW: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```
