Bulk product check

POST

/batch

curl --request POST \
  --url https://patchstack.com/database/api/beta/batch \
  --header 'Content-Type: application/json' \
  --header 'PSKey: <PSKey>' \
  --data '[ { "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 } ]'

• 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

Media type application/json

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.

Media type application/json

Array<object>

object

Example ^generated

[
  {}
]

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.