Productsup
Platform API

Status

Check the processing status of a site using a process identifier (PID) from the Platform API.

2 min read

The status endpoint returns the current processing state of a site for a given process identifier (PID). You obtain a PID when you call the Process endpoint.

The platform validates only the PID format — it does not check whether the PID exists. If you pass a valid but non-existent PID, the status will always be queued.

Get

curl -i -L -X GET \
  'https://platform-api.productsup.io/platform/v2/sites/<siteId>/status/<pid>'
{
    "success": true,
    "status": "failed",
    "links": [
        {
            "errors": "https://platform-api.productsup.io/platform/v2/sites/<siteId>/errors?pid=<pid>"
        },
        {
            "self": "https://platform-api.productsup.io/platform/v2/sites/<siteId>/status/<pid>"
        }
    ]
}

HTTP request

GET https://platform-api.productsup.io/platform/v2/sites/<siteId>/status/<pid>

URL parameters

FieldTypeDescription
siteIdintegerSite to which the PID belongs
pidstringProcess identifier to check

Response fields

FieldTypeDescription
successbooleanIndicates request status
statusstringSee status values
linksarrayLink to this resource and, when status is failed, to the site errors resource

Status values

ValueDescription
queuedThe PID is valid but the site has not started processing yet.
runningThe platform is currently processing the site's content.
successProcessing completed without errors.
failedProcessing completed with errors. Use the errors link in the response to retrieve details.

On this page

Still stuck?

Reach out to our support team and we’ll help you get unstuck.

Contact support