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

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

# Retrieve specific job

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

Requires the JOBOVERVIEW security role.

## Path parameters

- `id` (string, required)

## 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/jobs/{id}:
    get:
      description: Requires the JOBOVERVIEW security role.
      parameters:
        - example: 00000000-0000-0000-0000-000000000000
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    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: 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: {}
                    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
              schema:
                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
          description: Successful response
      security:
        - permanentToken:
            - JOBOVERVIEW
        - OAuth2:
            - JOBOVERVIEW
      summary: Retrieve specific job
      tags:
        - Jobs
security:
  - permanentToken:
      - JOBOVERVIEW
  - OAuth2:
      - JOBOVERVIEW
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
```