---
title: "/api/corpus"
method: GET
path: "/api/corpus"
tags: ["vulnerabilities"]
---

# /api/corpus

`GET /api/corpus`

## Request

- Base URL: `https://vulnerabilityhistory.org`
- URL: `https://vulnerabilityhistory.org/api/corpus`
- Auth: none required
- TypeScript: <https://skmtc.dev/vulnerabilityhistoryproject/apis/vulnerability-history-project-restful-api/docs/api/corpus/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of vulnerabilities filtered by having written langauge in the `description` and `mistakes` fields. Also includes tag data too. Use for research purposes.

## Response `200`

OK

- object[]
  - `id` integer
  - `cve` string
  - `project_name` string
  - `description` string
  - `mistakes` string
  - `tag_list` object[]
    - `id` integer
    - `tag` string

## Other responses

- `400`: Malformed request.
- `500`: Internal error. Please report these on our [issue tracker](https://github.com/VulnerabilityHistoryProject/vulnerability-history/issues).

## Changes

- **2023-03-15** `a9815c68a104`: 1 info
  - endpoint added
- **2022-07-01** `520c4d9ba9e9`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/vulnerabilityhistoryproject/apis/vulnerability-history-project-restful-api/changes/api/corpus/get.md)

---

[API](https://skmtc.dev/vulnerabilityhistoryproject/apis/vulnerability-history-project-restful-api.md) - [All operations](https://skmtc.dev/vulnerabilityhistoryproject/apis/vulnerability-history-project-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vulnerabilityhistoryproject/apis/vulnerability-history-project-restful-api/revisions/2390172697da?raw)