Skip to content
API documentation

Patchgrid API v1

A read-only JSON API over the vulnerability database. Plain HTTPS, bearer-token auth, predictable errors.

Getting started

  1. Request access. Tell us which IP addresses you will call from. We create an API user and a key for you.
  2. Keep the key secret. It looks like pgk_… and is shown once. It only works from the IP addresses registered for it; any other address gets 403.
  3. Send it as a bearer token in the Authorization header.
Base URLhttps://vuln.magicwp.io/api/v1
HeaderAuthorization: Bearer pgk_YOUR_KEY
FormatJSON. GET requests only.
Rate limitPer API user (60 requests/minute on the free plan); all keys of a user share it.

Stats

GET /api/v1/stats: record counts by severity and the time of the last refresh.

curl -H "Authorization: Bearer YOUR_API_KEY" "https://vuln.magicwp.io/api/v1/stats"
{
  "total": 44171,
  "critical": 2931,
  "high": 9246,
  "medium": 31794,
  "low": 200,
  "last_updated": "2026-11-15T20:00:40.446006+00:00"
}

GET /api/v1/vulnerabilities: a paged list. Every parameter is optional and they combine with AND.

# Critical plugin vulnerabilities, newest first, 20 per page
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://vuln.magicwp.io/api/v1/vulnerabilities?severity=Critical&type=plugin&per_page=20"

# Free-text search, unpatched only
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://vuln.magicwp.io/api/v1/vulnerabilities?q=woocommerce&patched=false"
ParameterValuesNotes
qtextMatches title, description, CVE, plugin/theme name or slug, or an exact record id
typeplugin | theme | coreRepeat to combine: type=plugin&type=theme
severityCritical | High | Medium | LowRepeatable
has_cvetrue | falseOnly records with (or without) a CVE id
patchedtrue | falsetrue: every affected entry has a fix. false: at least one has none
informationaltrue | falseInclude or exclude informational records
cwenumberWeakness id, e.g. 79 for XSS
min_score0–10Minimum CVSS score
published_from, published_toYYYY-MM-DDInclusive date range
updated_sinceISO timestampe.g. 2026-11-15T00:00:00Z. Pull only what changed since your last run
slugtextExact plugin or theme slug, e.g. woocommerce
sortpublished | updated | score | titleDefault published
orderdesc | ascDefault desc
page, per_pagenumbersDefaults 1 and 50; per_page is at most 100

One record

GET /api/v1/vulnerabilities/{id}: a single record by its id (every list item has one).

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://vuln.magicwp.io/api/v1/vulnerabilities/f424258a-367d-43cb-b66b-1f898391a0ea"
{
  "id": "f424258a-367d-43cb-b66b-1f898391a0ea",
  "title": "Give - Peer-to-Peer <= 2.9.5 - Authorization Bypass to Team Modification and Media Upload",
  "description": "The Give - Peer-to-Peer plugin for WordPress is vulnerable to authorization bypass in all versions up to, and including, 2.9.5. …",
  "cve": "CVE-2026-82663",
  "cve_link": "https://www.cve.org/CVERecord?id=CVE-2026-82663",
  "informational": false,
  "cwe_id": 863,
  "cwe_name": "Incorrect Authorization",
  "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:H/A:N",
  "cvss_score": 7.5,
  "cvss_rating": "High",
  "researchers": ["Alex Thomas", "Research Team"],
  "refs": ["https://…/original-record"],
  "published": "2026-11-14T20:40:21+00:00",
  "updated": "2026-11-15T09:34:46+00:00",
  "software": [
    { "type": "plugin", "name": "Give - Peer-to-Peer", "slug": "give-peer-to-peer",
      "patched": true, "patched_versions": ["2.9.6"],
      "remediation": "Update to version 2.9.6, or a newer patched version",
      "affected_versions": { "*-2.9.5": { "from_version": "*", "to_version": "2.9.5", "from_inclusive": true, "to_inclusive": true } } }
  ]
}

Check a plugin or theme

GET /api/v1/software/{plugin|theme|core}/{slug}?version=1.2.3: the question most integrations ask. With version only vulnerabilities affecting that version are returned and vulnerable is true or false.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://vuln.magicwp.io/api/v1/software/plugin/give-peer-to-peer?version=2.9.5"
{
  "type": "plugin",
  "slug": "give-peer-to-peer",
  "name": "Give - Peer-to-Peer",
  "known": true,
  "version": "2.9.5",
  "vulnerable": true,
  "count": 1,
  "vulnerabilities": [
    {
      "id": "f424258a-367d-43cb-b66b-1f898391a0ea",
      "title": "Give - Peer-to-Peer <= 2.9.5 - Authorization Bypass to Team Modification and Media Upload",
      "cve": "CVE-2026-82663",
      "cvss_score": 7.5,
      "cvss_rating": "High",
      "published": "2026-11-14T20:40:21+00:00",
      "updated": "2026-11-15T09:34:46+00:00",
      "informational": false,
      "affected_versions": [
        { "from_version": "*", "to_version": "2.9.5", "from_inclusive": true, "to_inclusive": true }
      ],
      "patched": true,
      "fixed_in": ["2.9.6"],
      "remediation": "Update to version 2.9.6, or a newer patched version"
    }
  ]
}

Errors & limits

Errors are JSON with a detail message.

StatusMeaning
401Missing, invalid, revoked or disabled key (also when the user is disabled)
403The key is valid but not allowed from this IP address, or a non-GET request
404Record not found
422A parameter is invalid (the message says which)
429Rate limit exceeded. Wait for the seconds in the Retry-After header
503API access is switched off by the admin

When rate limited, wait the number of seconds in the Retry-After header and try again.

Data © Defiant Inc. and The MITRE Corporation. If you republish it, keep their notices and link to the original record listed in refs.
Request API access