Get All Jobs

GET 
https://euwest.api.elasticpath.com/pcm/jobs

The jobs endpoints displays the status of a number of endpoints that function as jobs, for example, product import and export, price book import, building child products, and duplicating hierarchies.

Responses

200

Returns all the jobs.

application/json

Schema

Schema

data object[]required
An array of jobs.
Array [
idstringrequired
A unique identifier generated when a job is created.
typestringrequired
This represents the type of resource object being returned. Always pim-job.
Possible values: [pim-job]
attributes objectrequired
started_atdate-timenullablerequired
The date and time a job is started.
Example: 2020-09-22T09:00:00
completed_atdate-timenullablerequired
The date and time a job is completed.
Example: 2020-09-22T09:00:00
created_atdate-timerequired
The date and time a job is created.
Example: 2020-09-22T09:00:00
updated_atdate-timerequired
The date and time a job is updated.
Example: 2020-09-22T09:00:00
typestringrequired
The status of a job.
• pending - Commerce has received the request but is currently busy processing other requests.
• started - Commerce has started processing the job.
• success - The job has successfully completed.
• failed - The job has failed.
Possible values: [child-products, product-import, product-export, hierarchy-duplicate, price-import]
statusstringrequired
Possible values: [pending, cancelled, started, success, failed]
meta objectrequired
x_request_idstringrequired
Applies to all job types. A unique request ID is generated when a job is created.
copied_fromstring
Applies to hierarchy-duplicate job types. The ID of the original hierarchy that you duplicated.
hierarchy_idstring
Applies to hierarchy-duplicate job types. The duplicated hierarchy ID.
file_locationsstring[]nullable
If the job type is product_export, a link to the file is created when running a job.
filterstring
The entities included in the job. For example, if the job type is product-export, the PXM products included in the export.
]
meta objectrequired
results objectrequired
Contains the results for the entire collection.
totalintegerrequired
Total number of results for the entire collection.
Example: 2

Example (auto)

{
  "data": [
    {
      "id": "string",
      "type": "pim-job",
      "attributes": {
        "started_at": "2020-09-22T09:00:00",
        "completed_at": "2020-09-22T09:00:00",
        "created_at": "2020-09-22T09:00:00",
        "updated_at": "2020-09-22T09:00:00",
        "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
    }
  }
}

completed

Get all jobs

{
  "data": [
    {
      "type": "pim-job",
      "id": "1ea62172-57f6-45e5-a708-ab5bd634e3f9",
      "attributes": {
        "completed_at": "2024-01-05T13:46:42.142Z",
        "created_at": "2024-01-05T13:46:41.695Z",
        "started_at": "2024-01-05T13:46:42.07Z",
        "status": "success",
        "type": "product-import",
        "updated_at": "2024-01-05T13:46:42.07Z"
      },
      "meta": {
        "x_request_id": "7e832a26-d615-4305-b26a-e33c9c2fc06a"
      }
    },
    {
      "type": "pim-job",
      "id": "3ab3deca-1f11-47b7-a409-24ea3234d72c",
      "attributes": {
        "completed_at": null,
        "created_at": "2024-01-05T15:27:23.161Z",
        "started_at": "2024-01-05T15:27:23.65Z",
        "updated_at": "2024-01-05T15:27:23.65Z",
        "status": "started",
        "type": "product-import"
      },
      "meta": {
        "x_request_id": "9ac00140-0037-4c6a-913c-b812196a2de6"
      }
    },
    {
      "type": "pim-job",
      "id": "7e1b9ba1-c844-4556-9b16-4ae3f0988b0f",
      "attributes": {
        "completed_at": "2024-01-05T15:27:23.663Z",
        "created_at": "2024-01-05T15:27:23.161Z",
        "started_at": "2024-01-05T15:27:23.65Z",
        "updated_at": "2024-01-05T15:27:23.65Z",
        "status": "success",
        "type": "product-export"
      },
      "meta": {
        "file_locations": [],
        "filter": "eq(sku,product-1)",
        "x_request_id": "fad8c5c0-9546-4e0c-b68e-8a2d809891e5"
      }
    }
  ],
  "meta": {
    "results": {
      "total": 1
    }
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

bad-request

{
  "errors": [
    {
      "title": "Bad Request",
      "detail": "Could not parse the supplied filter",
      "status": "400"
    }
  ]
}

404

Bad Request. Not Found.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Not Found",
      "status": "404"
    }
  ]
}

422

Bad request. The request failed validation.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

failed-validation

{
  "errors": [
    {
      "title": "Failed Validation",
      "status": "422",
      "detail": "<XYZ> can not be empty"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "status": "500",
      "title": "Internal Server Error",
      "detail": "There was an internal server error, you can report with your request id.",
      "request_id": "635da56d-75a1-43cd-b696-7ab119756b3a"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://euwest.api.elasticpath.com/pcm/jobs");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

ResponseClear

Click the Send API Request button above and see the response here!