How to use the Vexday API: free key and first CVE request
Create the free key, fetch a CVE as JSON with severity, active exploitation and the risk score, and keep an eye on the account limit. To bring Vexday's data into your system.
What you need
- A Vexday account: just your email, no password and no card.
- A terminal with curl or any HTTP client.
Account limits: free, 50 per day and 10 per minute · SOC, 5,000 per day and 60 per minute · MSSP, 20,000 per day and 120 per minute.
Step by step
Create the key
In the dashboard, open Integrations and click New key. Give it a name, such as the system that will use it, and copy the key right away: it starts with vx_live_ and is shown only once.
Make the first request
Request a CVE's detail with the key in the Authorization header. The lang parameter picks the language of the translated fields: pt, es or en.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve/CVE-2024-3400?lang=en"
Read the response
The record comes in data: severity (cvss_score), exploitation probability (epss_score), active exploitation (in_kev), public proof of concept (has_public_poc) and Vexday's risk score (risk). The attribution field carries the source credits: keep it when you show the data.
Search for what matters to you
Search filters by vendor, product, severity, active exploitation and public proof of concept, sorted by risk. The /kev view returns only what is under active exploitation.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve?vendor=fortinet&in_kev=true&page_size=20"
Track your usage
/status shows the plan, today's requests and how many are left. The limit belongs to the account, adding up its keys; past it, the API answers 429 with the Retry-After header.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" "https://api.vexday.io/api/v1/status"