> ## Documentation Index
> Fetch the complete documentation index at: https://chainpatrol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar reportes de la organización

> Answers 'which of my organization's reports match these filters?'. Returns full report records — proposals, assets, scans, reporter, SLA — with filtering and pagination, newest first. The organization comes from your API key, or pass `slug` when your credentials can reach more than one. To check whether a report already exists for specific assets before filing a new one, use `POST /reports/search`, which looks reports up by asset content in a single batched call.

## Descripción general

Obtén los reportes de seguridad de tu organización. Este endpoint devuelve todos los reportes enviados para tu organización, con detalles sobre los **Assets** (activos digitales: URL, direcciones, perfiles, apps, etc.) reportados, las **Proposals** (propuestas para bloquear o permitir un asset) y su estado actual. La organización se infiere automáticamente a partir de tu clave de API.

## Inicio rápido

### Autenticación

Incluye tu clave de API en el encabezado `X-API-KEY`:

```bash theme={null}
X-API-KEY: your_api_key_here
```

### Solicitud de ejemplo

```typescript TypeScript theme={null}
const response = await fetch(
  "https://app.chainpatrol.io/api/v2/organization/reports?limit=50",
  {
    method: "GET",
    headers: {
      "X-API-KEY": "YOUR_API_KEY_HERE",
    },
  }
);

const data = await response.json();
console.log(data.reports);
```

```javascript JavaScript theme={null}
const response = await fetch(
  "https://app.chainpatrol.io/api/v2/organization/reports?limit=50",
  {
    method: "GET",
    headers: {
      "X-API-KEY": "YOUR_API_KEY_HERE",
    },
  }
);

const data = await response.json();
console.log(data.reports);
```

```python Python theme={null}
import requests

response = requests.get(
    "https://app.chainpatrol.io/api/v2/organization/reports",
    headers={
        "X-API-KEY": "YOUR_API_KEY_HERE",
    },
    params={
        "limit": 50,
    },
)

data = response.json()
print(data["reports"])
```

```bash cURL theme={null}
curl -X GET 'https://app.chainpatrol.io/api/v2/organization/reports?limit=50' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'
```

## Parámetros de consulta

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| limit | number | No | Cantidad de reportes que se devuelven por página (1-100, valor predeterminado: 50) |
| cursor | string | No | Cursor para la paginación. Pasa el cursor de la respuesta anterior para obtener la página siguiente. |
| startDate | string | No | Filtra los reportes creados después de esta fecha (formato ISO 8601) |
| endDate | string | No | Filtra los reportes creados antes de esta fecha (formato ISO 8601) |
| onlyRejected | boolean | No | Si es true, solo devuelve los reportes con Proposals rechazadas (valor predeterminado: false) |
| needsCustomerReview | boolean | No | Si es true, solo devuelve los reportes que tienen al menos una Proposal a la espera de **tu** revisión: la misma cola que muestra tu página **Review** (revisión de propuestas pendientes de aprobación). Úsalo para responder "¿qué está esperando por mí?" y luego actúa sobre las Proposals con [`POST /organization/proposals/{proposalId}/review`](https://chainpatrol.com/docs/es/external-api/organization-proposals-review). |

## Respuesta

### Respuesta exitosa

```json theme={null}
{
  "reports": [
    {
      "id": "rpt_1234567890abcdef",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "status": "APPROVED",
      "assets": [
        {
          "id": 12345,
          "content": "https://scam-site.com",
          "type": "URL",
          "status": "BLOCKED"
        }
      ],
      "proposals": [
        {
          "id": 4321,
          "reviewStatus": "PENDING",
          "asset": {
            "id": 12345,
            "type": "URL",
            "content": "https://scam-site.com",
            "status": "UNKNOWN"
          }
        }
      ]
    }
  ],
  "cursor": "next_page_cursor_string"
}
```

### Campos de la respuesta

| Campo | Tipo | Descripción |
| - | - | - |
| reports | array | Arreglo de objetos de reporte de tu organización |
| reports\[].id | string | Identificador único del reporte |
| reports\[].createdAt | string | Marca de tiempo ISO 8601 del momento en que se creó el reporte |
| reports\[].status | string | Estado general del reporte (`PENDING`, `APPROVED`, `REJECTED`) |
| reports\[].assets | array | Arreglo de assets incluidos en el reporte |
| reports\[].proposals | array | Arreglo de Proposals asociadas al reporte |
| reports\[].proposals\[].id | number | Identificador único de la Proposal. Pásalo a [`POST /organization/proposals/{proposalId}/review`](https://chainpatrol.com/docs/es/external-api/organization-proposals-review) para aprobar la Proposal, rechazarla o enviarla a la **Watchlist** (lista de seguimiento de assets sospechosos que se siguen monitoreando). |
| reports\[].proposals\[].reviewStatus | string | Estado de revisión de la Proposal (`PENDING`, `APPROVED`, `REJECTED`) |
| reports\[].proposals\[].asset | object | El asset al que apunta la Proposal. Su `id` es el `assetId` que requiere el endpoint de revisión. |
| cursor | string | Cursor para la página siguiente de resultados (undefined si no hay más resultados) |

## Paginación

Usa la paginación basada en cursor para obtener todos los reportes:

```typescript TypeScript theme={null}
async function fetchAllReports() {
  let allReports = [];
  let cursor: string | undefined = undefined;

  while (true) {
    const params = new URLSearchParams({
      limit: "100",
      ...(cursor && { cursor }),
    });

    const response = await fetch(
      `https://app.chainpatrol.io/api/v2/organization/reports?${params}`,
      {
        method: "GET",
        headers: {
          "X-API-KEY": "YOUR_API_KEY_HERE",
        },
      }
    );

    const data = await response.json();
    allReports = allReports.concat(data.reports);
    cursor = data.cursor;

    if (!cursor) {
      break;
    }
  }

  return allReports;
}

fetchAllReports()
  .then((reports) => console.log(`Total reports: ${reports.length}`))
  .catch((error) => console.error("Error:", error));
```

```python Python theme={null}
import requests

def fetch_all_reports():
    all_reports = []
    cursor = None

    while True:
        params = {"limit": 100}
        if cursor:
            params["cursor"] = cursor

        response = requests.get(
            "https://app.chainpatrol.io/api/v2/organization/reports",
            headers={"X-API-KEY": "YOUR_API_KEY_HERE"},
            params=params,
        )

        data = response.json()
        all_reports.extend(data["reports"])
        cursor = data.get("cursor")

        if not cursor:
            break

    return all_reports

try:
    reports = fetch_all_reports()
    print(f"Total reports: {len(reports)}")
except Exception as error:
    print(f"Error: {str(error)}")
```

## Ejemplos de filtros

### Filtrar por rango de fechas

Obtén los reportes de un período específico:

```bash theme={null}
curl -X GET 'https://app.chainpatrol.io/api/v2/organization/reports?startDate=2024-01-01T00:00:00Z&endDate=2024-03-31T23:59:59Z' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'
```

### Filtrar solo los reportes rechazados

Obtén los reportes que tienen Proposals rechazadas:

```bash theme={null}
curl -X GET 'https://app.chainpatrol.io/api/v2/organization/reports?onlyRejected=true' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'
```

### Filtrar los reportes que esperan tu revisión

Obtén los reportes que tienen al menos una Proposal a la espera de tu organización: la misma cola que muestra tu página Review:

```bash theme={null}
curl -X GET 'https://app.chainpatrol.io/api/v2/organization/reports?needsCustomerReview=true&limit=20' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'
```

Cada reporte devuelto trae en `proposals[]` las Proposals sobre las que hay que actuar. Toma de ahí `proposals[].id` y `proposals[].asset.id` y pasa ambos a [`POST /organization/proposals/{proposalId}/review`](https://chainpatrol.com/docs/es/external-api/organization-proposals-review).

### Combinar filtros

Obtén los reportes rechazados de un rango de fechas específico:

```bash theme={null}
curl -X GET 'https://app.chainpatrol.io/api/v2/organization/reports?startDate=2024-01-01T00:00:00Z&endDate=2024-03-31T23:59:59Z&onlyRejected=true&limit=100' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'
```

## Respuestas de error

### 401 Unauthorized

Se devuelve cuando la clave de API falta, no es válida o no tiene acceso a la organización:

```json theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key with organization access required"
  }
}
```

### 400 Bad Request

Se devuelve cuando los parámetros de consulta no son válidos:

```json theme={null}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid date format. Use ISO 8601 format."
  }
}
```

## Casos de uso

### Monitorear los reportes recientes

```typescript theme={null}
async function getRecentReports(days: number = 7) {
  const startDate = new Date();
  startDate.setDate(startDate.getDate() - days);

  const response = await fetch(
    `https://app.chainpatrol.io/api/v2/organization/reports?startDate=${startDate.toISOString()}&limit=100`,
    {
      headers: { "X-API-KEY": "YOUR_API_KEY_HERE" },
    }
  );

  const { reports } = await response.json();
  console.log(`Found ${reports.length} reports in the last ${days} days`);
  return reports;
}
```

### Dar seguimiento a los reportes rechazados

```typescript theme={null}
async function analyzeRejectedReports() {
  const response = await fetch(
    "https://app.chainpatrol.io/api/v2/organization/reports?onlyRejected=true",
    {
      headers: { "X-API-KEY": "YOUR_API_KEY_HERE" },
    }
  );

  const { reports } = await response.json();

  // Analyze rejection reasons
  const rejectionReasons = reports.flatMap((report) =>
    report.proposals
      .filter((p) => p.status === "REJECTED")
      .map((p) => p.rejectionReason)
  );

  console.log("Common rejection reasons:", rejectionReasons);
  return rejectionReasons;
}
```

### Exportar reportes a CSV

```typescript theme={null}
async function exportReportsToCSV(startDate: string, endDate: string) {
  const response = await fetch(
    `https://app.chainpatrol.io/api/v2/organization/reports?startDate=${startDate}&endDate=${endDate}&limit=100`,
    {
      headers: { "X-API-KEY": "YOUR_API_KEY_HERE" },
    }
  );

  const { reports } = await response.json();

  const csvHeader = "Report ID,Created At,Status,Assets,Proposals\n";
  const csvRows = reports
    .map(
      (r) =>
        `${r.id},${r.createdAt},${r.status},${r.assets.length},${r.proposals.length}`
    )
    .join("\n");

  const csv = csvHeader + csvRows;

  // Save or return CSV
  return csv;
}
```

## Buenas prácticas

### Paginación

* Usa `limit=100` para obtener datos en bloque y reducir al mínimo las llamadas a la API
* Revisa siempre el campo `cursor` para saber si hay más resultados
* Guarda el cursor si necesitas retomar la paginación más adelante

### Filtros por fecha

* Usa siempre el formato ISO 8601 para las fechas: `YYYY-MM-DDTHH:mm:ss.sssZ`
* Incluye la información de la zona horaria (normalmente UTC con el sufijo `Z`)
* Usa `startDate` y `endDate` juntos para definir rangos de tiempo precisos

### Rendimiento

* Guarda en caché los datos de los reportes cuando corresponda para reducir las llamadas a la API
* Usa filtros de fecha para limitar el tamaño del conjunto de resultados
* Si monitoreas la llegada de reportes nuevos, define intervalos de consulta periódica (se recomiendan de 5 a 10 minutos)

## Notas

* La organización se determina automáticamente a partir de tu clave de API
* Todas las marcas de tiempo están en formato ISO 8601 con zona horaria UTC
* El filtro `onlyRejected` muestra los reportes que tienen al menos una Proposal rechazada, pero el reporte puede contener otras Proposals aprobadas
* Los reportes se ordenan por fecha de creación (los más recientes primero)
* El cursor es opaco y no se debe analizar ni modificar


## OpenAPI

````yaml GET /organization/reports
openapi: 3.0.3
info:
  title: ChainPatrol External API - OpenAPI 3.0
  description: ChainPatrol External API documentation
  version: 2.0.0
servers:
  - url: https://app.chainpatrol.io/api/v2
security: []
tags:
  - name: asset
  - name: report
  - name: dark-web
externalDocs:
  url: https://chainpatrol.com/docs
paths:
  /organization/reports:
    get:
      tags:
        - organization
      summary: List organization reports
      description: >-
        Answers 'which of my organization's reports match these filters?'.
        Returns full report records — proposals, assets, scans, reporter, SLA —
        with filtering and pagination, newest first. The organization comes from
        your API key, or pass `slug` when your credentials can reach more than
        one. To check whether a report already exists for specific assets before
        filing a new one, use `POST /reports/search`, which looks reports up by
        asset content in a single batched call.
      operationId: organizationReportsList
      parameters:
        - in: query
          name: limit
          schema:
            type: number
            minimum: 1
            maximum: 20
          required: true
        - in: query
          name: cursor
          schema:
            type: number
            nullable: true
        - in: query
          name: status
          schema:
            type: string
            enum:
              - TODO
              - IN_PROGRESS
              - CLOSED
        - in: query
          name: searchQuery
          schema:
            type: string
        - in: query
          name: reporterQuery
          schema:
            type: string
        - in: query
          name: reporterKind
          schema:
            type: string
            enum:
              - human
              - automation
              - machine_user
        - in: query
          name: reviewerKind
          schema:
            type: string
            enum:
              - human
              - automation
        - in: query
          name: reviewedByUserId
          schema:
            type: number
            nullable: true
        - in: query
          name: startDate
          schema:
            type: string
        - in: query
          name: endDate
          schema:
            type: string
        - in: query
          name: updatedAtStartDate
          schema:
            type: string
        - in: query
          name: updatedAtEndDate
          schema:
            type: string
        - in: query
          name: registrars
          schema:
            type: array
            items:
              type: string
        - in: query
          name: hasMxRecords
          schema:
            type: boolean
        - in: query
          name: slug
          schema:
            type: string
        - in: query
          name: excludeAutomation
          schema:
            type: boolean
            default: false
        - in: query
          name: onlyRejected
          schema:
            type: boolean
            default: false
        - in: query
          name: onlyFavorited
          schema:
            type: boolean
            default: false
        - in: query
          name: reportedByCustomer
          schema:
            type: boolean
        - in: query
          name: hasAttachments
          schema:
            type: boolean
        - in: query
          name: needsCustomerReview
          schema:
            type: boolean
        - in: query
          name: reviewStatuses
          schema:
            type: array
            items:
              type: string
              enum:
                - APPROVE
                - REJECT
                - SKIP
                - ESCALATE
        - in: query
          name: assetTypes
          schema:
            type: array
            items:
              type: string
              enum:
                - URL
                - PAGE
                - ADDRESS
                - DISCORD
                - LINKEDIN
                - TWITTER
                - FACEBOOK
                - YOUTUBE
                - REDDIT
                - TELEGRAM
                - GOOGLE_APP_STORE
                - APPLE_APP_STORE
                - AMAZON_APP_STORE
                - MICROSOFT_APP_STORE
                - TIKTOK
                - INSTAGRAM
                - THREADS
                - MEDIUM
                - CHROME_WEB_STORE
                - MOZILLA_ADDONS
                - OPERA_ADDONS
                - EMAIL
                - PATREON
                - OPENSEA
                - FARCASTER
                - IPFS
                - GOOGLE_FORM
                - WHATSAPP
                - DISCORD_USER
                - QUORA
                - GITHUB
                - TEACHABLE
                - SUBSTACK
                - DEBANK
                - TAWK_TO
                - JOTFORM
                - PRIMAL
                - BLUESKY
                - SNAPCHAT
                - DESO
                - PINTEREST
                - FLICKR
                - GALXE
                - VELOG
                - NPM
                - PYPI
                - HEX
                - DOCKER_HUB
                - VOCAL_MEDIA
                - TECKFINE
                - TENDERLY
                - HACKMD
                - ETSY
                - ZAZZLE
                - BASENAME
                - BILIBILI_TV
                - VIMEO
                - DAILYMOTION
                - PHONE_NUMBER
                - SLACK
                - CALENDLY
                - NGROK
                - RARIBLE
                - RUST_PACKAGE
                - FLATHUB
                - VIDLII
                - VEVIOZ
                - ISSUU
                - SOUNDCLOUD
                - ZAPPER
                - REDNOTE
                - SAMSUNG_APP_STORE
                - HUAWEI_APP_STORE
                - XIAOMI_APP_STORE
                - TENCENT_APP_STORE
                - OPPO_APP_STORE
                - VIVO_APP_STORE
                - F_DROID
                - GOOGLE_AD
                - BING_AD
                - TWITCH
                - BEHANCE
                - ZORA
                - META_AD
                - SIGNAL
                - DEVIANTART
                - BANDCAMP
                - ARCHIVE_ORG
                - FIVE_HUNDRED_PX
                - LUMA
                - SMARTMONEYMATCH
                - APK_GOLD
                - GLASSDOOR
                - PUMP_FUN
                - TUMBLR
                - MASTODON
        - in: query
          name: brandIds
          schema:
            type: array
            items:
              type: number
        - in: query
          name: countryCodes
          schema:
            type: array
            items:
              type: string
              minLength: 2
              maxLength: 2
        - in: query
          name: sources
          schema:
            type: array
            items:
              type: string
              enum:
                - APP
                - API
                - CANARY_TOKEN
                - AUTO_DETECTION
                - ASSET_MANAGEMENT
        - in: query
          name: threatActorIds
          schema:
            type: array
            items:
              type: number
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reports:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                        title:
                          type: string
                        description:
                          type: string
                        imageDisplay:
                          type: string
                          enum:
                            - VISIBLE
                            - BLUR
                            - HIDDEN
                        favoritedAt:
                          type: string
                          nullable: true
                        status:
                          type: string
                          nullable: true
                          enum:
                            - TODO
                            - IN_PROGRESS
                            - CLOSED
                            - null
                        reportedByCustomer:
                          type: boolean
                        slaDueAt:
                          type: string
                          nullable: true
                          description: >-
                            SLA deadline for this report. `null` when no SLA
                            applies (e.g. staff-created reports). Compare with
                            the current time to identify reports that are late
                            or due soon.
                        externalSubmissionLink:
                          type: string
                          nullable: true
                          description: >-
                            URL to the original external source of the report,
                            when it was submitted from a third-party surface
                            (e.g. a Discord/Twitter message link, or a webform
                            we forwarded through). `null` for reports created
                            directly in ChainPatrol.
                        duplicateOfId:
                          type: number
                          nullable: true
                          description: >-
                            ID of the canonical report this one duplicates.
                            `null` when the report is not a duplicate. Group by
                            this to dedupe when counting unique reports.
                        threatActor:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                          required:
                            - id
                            - name
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                        attachments:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: number
                              url:
                                type: string
                            required:
                              - id
                              - url
                        proposals:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: number
                                description: >-
                                  Proposal ID. Pass this to `POST
                                  /organization/proposals/{proposalId}/review`
                                  to approve or reject the proposal.
                              reviewStatus:
                                type: string
                                enum:
                                  - PENDING
                                  - APPROVED
                                  - REJECTED
                              asset:
                                type: object
                                properties:
                                  id:
                                    type: number
                                  type:
                                    type: string
                                    enum:
                                      - URL
                                      - PAGE
                                      - ADDRESS
                                      - DISCORD
                                      - LINKEDIN
                                      - TWITTER
                                      - FACEBOOK
                                      - YOUTUBE
                                      - REDDIT
                                      - TELEGRAM
                                      - GOOGLE_APP_STORE
                                      - APPLE_APP_STORE
                                      - AMAZON_APP_STORE
                                      - MICROSOFT_APP_STORE
                                      - TIKTOK
                                      - INSTAGRAM
                                      - THREADS
                                      - MEDIUM
                                      - CHROME_WEB_STORE
                                      - MOZILLA_ADDONS
                                      - OPERA_ADDONS
                                      - EMAIL
                                      - PATREON
                                      - OPENSEA
                                      - FARCASTER
                                      - IPFS
                                      - GOOGLE_FORM
                                      - WHATSAPP
                                      - DISCORD_USER
                                      - QUORA
                                      - GITHUB
                                      - TEACHABLE
                                      - SUBSTACK
                                      - DEBANK
                                      - TAWK_TO
                                      - JOTFORM
                                      - PRIMAL
                                      - BLUESKY
                                      - SNAPCHAT
                                      - DESO
                                      - PINTEREST
                                      - FLICKR
                                      - GALXE
                                      - VELOG
                                      - NPM
                                      - PYPI
                                      - HEX
                                      - DOCKER_HUB
                                      - VOCAL_MEDIA
                                      - TECKFINE
                                      - TENDERLY
                                      - HACKMD
                                      - ETSY
                                      - ZAZZLE
                                      - BASENAME
                                      - BILIBILI_TV
                                      - VIMEO
                                      - DAILYMOTION
                                      - PHONE_NUMBER
                                      - SLACK
                                      - CALENDLY
                                      - NGROK
                                      - RARIBLE
                                      - RUST_PACKAGE
                                      - FLATHUB
                                      - VIDLII
                                      - VEVIOZ
                                      - ISSUU
                                      - SOUNDCLOUD
                                      - ZAPPER
                                      - REDNOTE
                                      - SAMSUNG_APP_STORE
                                      - HUAWEI_APP_STORE
                                      - XIAOMI_APP_STORE
                                      - TENCENT_APP_STORE
                                      - OPPO_APP_STORE
                                      - VIVO_APP_STORE
                                      - F_DROID
                                      - GOOGLE_AD
                                      - BING_AD
                                      - TWITCH
                                      - BEHANCE
                                      - ZORA
                                      - META_AD
                                      - SIGNAL
                                      - DEVIANTART
                                      - BANDCAMP
                                      - ARCHIVE_ORG
                                      - FIVE_HUNDRED_PX
                                      - LUMA
                                      - SMARTMONEYMATCH
                                      - APK_GOLD
                                      - GLASSDOOR
                                      - PUMP_FUN
                                      - TUMBLR
                                      - MASTODON
                                  content:
                                    type: string
                                  status:
                                    type: string
                                    enum:
                                      - UNKNOWN
                                      - ALLOWED
                                      - BLOCKED
                                  scans:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: number
                                        status:
                                          type: string
                                          enum:
                                            - PENDING
                                            - IN_PROGRESS
                                            - COMPLETED
                                            - FAILED
                                        output:
                                          nullable: true
                                        createdAt:
                                          type: string
                                        enrichments:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              id:
                                                type: number
                                              type:
                                                type: string
                                              output:
                                                nullable: true
                                              status:
                                                type: string
                                            required:
                                              - id
                                              - type
                                              - status
                                      required:
                                        - id
                                        - status
                                        - createdAt
                                        - enrichments
                                required:
                                  - id
                                  - type
                                  - content
                                  - status
                                  - scans
                            required:
                              - id
                              - reviewStatus
                              - asset
                        reporter:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: number
                            role:
                              type: string
                              enum:
                                - SUPERUSER
                                - SYSTEM
                                - CUSTOMER
                                - SUPPORT
                                - REVIEWER
                                - REPORTER
                                - MANAGER
                                - READ_ONLY
                            fullName:
                              type: string
                            avatarUrl:
                              type: string
                              nullable: true
                          required:
                            - id
                            - role
                            - fullName
                            - avatarUrl
                        externalReporter:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: number
                            displayName:
                              type: string
                              nullable: true
                            avatarUrl:
                              type: string
                              nullable: true
                            platform:
                              type: string
                          required:
                            - id
                            - displayName
                            - avatarUrl
                            - platform
                        source:
                          type: string
                          nullable: true
                          enum:
                            - APP
                            - API
                            - CANARY_TOKEN
                            - AUTO_DETECTION
                            - ASSET_MANAGEMENT
                            - null
                        sourceMetadata:
                          nullable: true
                      required:
                        - id
                        - title
                        - description
                        - imageDisplay
                        - favoritedAt
                        - status
                        - reportedByCustomer
                        - slaDueAt
                        - externalSubmissionLink
                        - duplicateOfId
                        - threatActor
                        - createdAt
                        - updatedAt
                        - attachments
                        - proposals
                        - reporter
                        - externalReporter
                        - source
                  nextCursor:
                    type: number
                    nullable: true
                  totalCount:
                    type: number
                required:
                  - reports
                  - nextCursor
                  - totalCount
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.BAD_REQUEST'
        '401':
          description: Authorization not provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.UNAUTHORIZED'
        '403':
          description: Insufficient access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.FORBIDDEN'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.NOT_FOUND'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR'
      security:
        - ApiKey: []
components:
  schemas:
    error.BAD_REQUEST:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Invalid input data
        code:
          type: string
          description: The error code
          example: BAD_REQUEST
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Invalid input data error (400)
      description: The error information
      example:
        code: BAD_REQUEST
        message: Invalid input data
        issues: []
    error.UNAUTHORIZED:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Authorization not provided
        code:
          type: string
          description: The error code
          example: UNAUTHORIZED
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Authorization not provided error (401)
      description: The error information
      example:
        code: UNAUTHORIZED
        message: Authorization not provided
        issues: []
    error.FORBIDDEN:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Insufficient access
        code:
          type: string
          description: The error code
          example: FORBIDDEN
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Insufficient access error (403)
      description: The error information
      example:
        code: FORBIDDEN
        message: Insufficient access
        issues: []
    error.NOT_FOUND:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Not found
        code:
          type: string
          description: The error code
          example: NOT_FOUND
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Not found error (404)
      description: The error information
      example:
        code: NOT_FOUND
        message: Not found
        issues: []
    error.INTERNAL_SERVER_ERROR:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Internal server error
        code:
          type: string
          description: The error code
          example: INTERNAL_SERVER_ERROR
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Internal server error error (500)
      description: The error information
      example:
        code: INTERNAL_SERVER_ERROR
        message: Internal server error
        issues: []
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Your API key. This is required by most endpoints to access our API
        programatically. Reach out to us at
        [support@chainpatrol.io](mailto:support@chainpatrol.io?subject=Re:%20API%20Key%20for%20SDK&body=Company:%20%0AName:%20%0APurpose:%20)
        to get an API key for your use.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.