Getting started
- Request access. Tell us which IP addresses you will call from. We create an API user and a key for you.
- 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 gets403. - Send it as a bearer token in the
Authorizationheader.
| Base URL | https://vuln.magicwp.io/api/v1 |
| Header | Authorization: Bearer pgk_YOUR_KEY |
| Format | JSON. GET requests only. |
| Rate limit | Per 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"
}Search vulnerabilities
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"| Parameter | Values | Notes |
|---|---|---|
q | text | Matches title, description, CVE, plugin/theme name or slug, or an exact record id |
type | plugin | theme | core | Repeat to combine: type=plugin&type=theme |
severity | Critical | High | Medium | Low | Repeatable |
has_cve | true | false | Only records with (or without) a CVE id |
patched | true | false | true: every affected entry has a fix. false: at least one has none |
informational | true | false | Include or exclude informational records |
cwe | number | Weakness id, e.g. 79 for XSS |
min_score | 0–10 | Minimum CVSS score |
published_from, published_to | YYYY-MM-DD | Inclusive date range |
updated_since | ISO timestamp | e.g. 2026-11-15T00:00:00Z. Pull only what changed since your last run |
slug | text | Exact plugin or theme slug, e.g. woocommerce |
sort | published | updated | score | title | Default published |
order | desc | asc | Default desc |
page, per_page | numbers | Defaults 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.
| Status | Meaning |
|---|---|
401 | Missing, invalid, revoked or disabled key (also when the user is disabled) |
403 | The key is valid but not allowed from this IP address, or a non-GET request |
404 | Record not found |
422 | A parameter is invalid (the message says which) |
429 | Rate limit exceeded. Wait for the seconds in the Retry-After header |
503 | API 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.