Bulk product check

POST

/batch

• Production

Check up to 50 products in a single request. Mirrors the format documented for the Extended tier’s /batch endpoint.

The payload is a raw JSON array (not wrapped in an object). Each item is { "type", "name", "version", "exists"? } — when exists: true the result for that item is boolean-only; otherwise it’s the full advisory list for the product.

Authorizations

• PSKey

Request Body ^required

Array<object>

<= 50 items

object

type

required

string

Allowed values: npm plugin theme wordpress

name

required

string

version

required

string

exists

When true, return a boolean-only result for this item.

boolean

Example

[
  {
    "type": "npm",
    "name": "axios",
    "version": "0.21.4",
    "exists": false
  },
  {
    "type": "plugin",
    "name": "tutor",
    "version": "1.5.2",
    "exists": true
  },
  {
    "type": "wordpress",
    "name": "wordpress",
    "version": "6.0.0",
    "exists": true
  }
]

Responses

200

Per-item results, in request order.

Array<object>

object

401

Missing or invalid PSKey header.

403

API key not authorised for the requested endpoint.

422

Invalid parameter combination (e.g. cursor + page), invalid platform, or per_page > 500.

429

Rate limit exceeded.