---
title: "Get a list of disclosures"
method: GET
path: "/dataleaks/disclosures"
tags: ["dataleaks"]
---

# Get a list of disclosures

`GET /dataleaks/disclosures`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/dataleaks/disclosures`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/dataleaks/disclosures/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of the disclosures in your account matching the given filters.

Required API key permissions: `DataLeaks` (select when creating API key in Account Settings)

## Query parameters

- `min_time` string, date-time
- `max_time` string, date-time
- `statuses` 'Disclosed' | 'Acknowledged' | 'Investigating' | 'Remediating' | 'ClosedNoIssue' | 'ClosedRiskAccepted' | 'ClosedFixedUnverified' | 'ClosedFixedVerified'
- `ids` string

## Response `200`

Data Leaks disclosed

- DataLeaksDisclosuresResponsePayloadBody
  - `disclosures` DataLeaksDisclosure[]
    - `date_disclosed` string, date-time: The date this disclosure was created (RFC 3339)
    - `description` string: Description of the disclosure
    - `id` integer: The ID of the disclosure
    - `image` string: An image/screenshot of the disclosure
    - `implication` string: The nature of the risk
    - `payload` string: The JSON payload of the finding, if applicable
    - `severity` integer: The severity of the disclosure, between 1 and 10
    - `significance` string: A more detailed explanation of the significance/severity of the disclosure
    - `source` string: The person or source the finding has been attributed to
    - `status` string: Current status of the disclosure
    - `url` string: The URL to the finding

## Other responses

- `403`: Your API key does not have permission to perform this action.
- `422`: An invalid parameter was supplied or a mandatory parameter was missing
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)