---
title: "List saved custom reports"
method: POST
path: "/api/v2/custom-reports/list"
tags: ["Custom Reports"]
---

# List saved custom reports

`POST /api/v2/custom-reports/list`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/custom-reports/list`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

List all saved custom reports for an organization. Each custom report is a named set of filters that can be applied to view security issues matching specific criteria. Returns reports ordered by creation date (newest first).

## Request body

- CustomReportListInput: Input for listing saved custom reports
  - `organizationId` string: Organization ID to list custom reports for. If omitted, resolved from the authenticated session.

## Response `200`

List of saved custom reports

- CustomReportSummary[]
  - `id` string, required: Unique identifier for the saved custom report
  - `name` string, required: Display name of the custom report
  - `filters` CustomReportFilter[], required: Array of filters that define this custom report
    - `id` string, required: Unique identifier for this filter within the report
    - `fieldKey` 'severityLevel' | 'severity' | 'score' | 'status' | 'vulnCategory' | 'vulnClass' | 'validated' | 'reachability' | 'runtimeValidationVerdict' | 'cvssAttackVector' | 'cvssAttackComplexity' | 'cvssPrivilegesRequired' | 'cvssUserInteraction' | 'runtimeValidationSetupRequirement' | 'isNew' | 'hasWizExposure' | 'secretVerified' | 'search' | 'language' | 'detectedDate' | 'resolvedDate' | 'repositoryName' | 'branch' | 'tag' | 'scanType', required: Canonical field key for this filter. Do not invent field names; use `customReports.filterSchema` to discover supported values.
    - `operatorKey` 'is' | 'isNot' | 'isAnyOf' | 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'equals' | 'startsWith' | 'isUnknown' | 'isTrue' | 'before' | 'after' | 'inLastNDays' | 'onOrAfter' | 'onOrBefore', required: Canonical operator key for this filter. Valid operators depend on the chosen field. Call `customReports.filterSchema` first.
    - `value` union, required: The filter value; shape depends on the selected field and operator. Use the filter schema endpoint to determine the correct format.
      - string
      - number
      - boolean
      - string[]: Array of string values for multi-select filters
      - string[]: Tuple of two strings for range filters (e.g. date range)
      - number[]: Tuple of two numbers for numeric range filters
  - `createdAt` string, date-time, required: Timestamp when the custom report was created
  - `createdByUser` CustomReportUser: Summary of the user who created a custom report
    - `id` string, required: User ID
    - `fName` string, nullable, required: First name of the user
    - `lName` string, nullable, required: Last name of the user

## Other responses

- `401`: Error Response

---

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