Get All Jobs

GET/pcm/jobs

Use it in a workflow

Add a step and choose the Elastic Path connector.
Pick the Get All Jobs action (under PIM).
Fill in the fields below, then reference the result from later steps as {{getAllJobs.response.data}}.

Fields

baseUrlstring

The API host this action calls. Choose one, or pick Custom to enter your own.

One ofhttps://euwest.api.elasticpath.comhttps://useast.api.elasticpath.com__custom__Default "https://euwest.api.elasticpath.com"

baseUrlCustomstring

forwardAllHeadersboolean

If enabled, all headers from the incoming request will be forwarded. Additional headers below will override forwarded ones.

Default false

headerskeyvalue

Extra HTTP headers to include, beyond what this action already declares. These override forwarded or declared headers with the same name.

queryParamskeyvalue

Extra URL query parameters to include, beyond what this action already declares. These override declared query parameters with the same name.

Response

Returns 200 with an object. Read it in later steps with {{getAllJobs.response.data.<field>}}.

linksobject

Links allow you to navigate between pages of results. :::caution Planned pagination changes — on or after 1 September 2026 The pagination behaviour of PIM list endpoints (for example, `GET /pcm/products` and `GET /pcm/hierarchies`) currently differs from the rest of the Elastic Path Commerce Cloud platform. We plan to align PIM pagination with the platform standard on or after **1 September 2026**. Please review the details below and check that your integration code will handle the new behaviour correctly. ::: #### Current behaviour The current pagination link behaviour in PIM has the following known issues: - The `current` link is **not returned**. - The `first` and `last` links are **not always returned**. - The `prev` link is omitted on both the first **and** second pages. It should only be omitted on the first page. - The `next` link is omitted on both the last **and** second-to-last pages. It should only be omitted on the last page. #### Planned behaviour (on or after 1 September 2026) On or after 1 September 2026, PIM list endpoints will adopt the following pagination link behaviour, aligning with the rest of the platform: - `current` — always present, pointing to the current page. - `first` — always present. - `last` — present on all pages **except the final page**. Omitting `last` on the final page is intentional, to avoid triggering infinite‑loop bugs in integration code that uses the presence of `last` to detect whether more pages remain. - `next` — present on all pages except the last page. - `prev` — present on all pages except the first page.

currentstring

A link to the current page of results. **Note:** this link is not currently returned by PIM endpoints. It will be introduced on or after 1 September 2026.

firststring

A link to the first page of results. Currently this may not always be present. After the planned changes it will always be present.

laststring

A link to the last page of results. Currently this may not always be present. After the planned changes it will be present on all pages except the final page (where it is intentionally omitted).

nextstring

A link to the next page of results. Should be absent on the last page. Currently this is incorrectly absent on the second-to-last page as well; this will be fixed on or after 1 September 2026.

prevstring

A link to the previous page of results. Should be absent on the first page. Currently this is incorrectly absent on the second page as well; this will be fixed on or after 1 September 2026.

dataarray<object>

An array of jobs.

idstringrequired

A unique identifier generated when a job is created.

typestringrequired

This represents the type of resource object being returned. Always `pim-job`.

One ofpim-job

attributesobjectrequired6 fields

metaobjectrequired5 fields

metaobject

resultsobjectrequired1 fields

Contains the results for the entire collection.

json

{
  "data": [
    {
      "id": "string",
      "type": "pim-job",
      "attributes": {
        "started_at": "2020-09-22T09:00:00.000Z",
        "completed_at": "2020-09-22T09:00:00.000Z",
        "created_at": "2020-09-22T09:00:00.000Z",
        "updated_at": "2020-09-22T09:00:00.000Z",
        "type": "child-products",
        "status": "pending"
      },
      "meta": {
        "x_request_id": "string",
        "copied_from": "string",
        "hierarchy_id": "string",
        "file_locations": [
          "string"
        ],
        "filter": "string"
      }
    }
  ],
  "meta": {
    "results": {
      "total": 2
    }
  },
  "links": {
    "current": "/pcm/hierarchies?page[offset]=10&page[limit]=10",
    "first": "/pcm/hierarchies?page[offset]=0&page[limit]=10",
    "last": "/pcm/hierarchies?page[offset]=20&page[limit]=10",
    "next": "/pcm/hierarchies?page[offset]=10&page[limit]=10",
    "prev": "/pcm/hierarchies?page[offset]=8&page[limit]=10"
  }
}

Need more? See the Elastic Path guide for connection setup and behaviour shared by every action.

Was this page helpful?