> ## 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.

# Obtener reporte de la organización

> Answers 'what happened to this report?'. Takes a report ID, for example from a report link (app.chainpatrol.io/admin/<slug>/reports/<reportId>), and returns the report, how many evidence files are attached to it, and each of its assets: ChainPatrol's review, the asset's status and whether it was still online when last checked, and your organization's takedown of it. Only your organization's reports: any other ID returns 404. To find reports by filters instead, use `GET /organization/reports`.

## Descripción general

Obtén uno de los reportes de tu organización por su ID, con lo que pasó con cada **Asset** (activo digital: URL, dirección, perfil, app, etc.) que contiene: la revisión de ChainPatrol, si el asset está bloqueado, si seguía online la última vez que se verificó y el **Takedown** (solicitud de baja de contenido fraudulento) de tu organización.

Úsalo para responder "¿qué pasó con este reporte?" o "¿por qué esto sigue activo?" sobre un reporte que ya tienes, por ejemplo a partir del enlace de un reporte en la app de ChainPatrol. El ID es el número que aparece al final del enlace: `app.chainpatrol.io/admin/<slug>/reports/<reportId>`. Si en cambio quieres buscar reportes con filtros, usa [`GET /organization/reports`](https://chainpatrol.com/docs/es/external-api/organization-reports-list).

La organización se infiere a partir de tu clave de API. Solo se devuelven los reportes de tu organización: cualquier otro ID devuelve `404`, igual que un ID que no existe.

## 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 reportId = 1823334;

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

const { report } = await response.json();
console.log(report.assets);
```

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

report_id = 1823334

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

report = response.json()["report"]
print(report["assets"])
```

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

## Parámetros de ruta

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| reportId | number | Sí | El ID del reporte, tal como aparece en su enlace: `app.chainpatrol.io/admin/<slug>/reports/<reportId>` |

## Parámetros de consulta

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| slug | string | No | Slug de la organización. Omítelo si usas una clave de API de organización, que ya determina la organización. Solo hace falta cuando tus credenciales tienen acceso a más de una organización. |

## Respuesta

### Respuesta exitosa

```json theme={null}
{
  "report": {
    "id": 1823334,
    "title": "Fake wallet site",
    "description": "Phishing site impersonating our wallet",
    "status": "IN_PROGRESS",
    "reportedByCustomer": true,
    "slaDueAt": "2026-10-21T18:00:00.000Z",
    "duplicateOfId": null,
    "createdAt": "2026-10-20T18:00:00.000Z",
    "updatedAt": "2026-10-21T09:12:00.000Z",
    "assets": [
      {
        "proposalId": 4321,
        "reviewStatus": "APPROVED",
        "asset": {
          "id": 12345,
          "type": "URL",
          "content": "https://fake-wallet.example",
          "status": "BLOCKED",
          "livenessStatus": "ALIVE"
        },
        "takedown": {
          "id": 987,
          "status": "IN_PROGRESS",
          "createdAt": "2026-10-20T19:05:00.000Z",
          "updatedAt": "2026-10-21T08:40:00.000Z"
        }
      }
    ]
  }
}
```

### Campos de la respuesta

| Campo | Tipo | Descripción |
| - | - | - |
| report.id | number | El ID del reporte |
| report.title | string | El título del reporte |
| report.description | string | La descripción del reporte |
| report.status | string \| null | El estado del reporte: `TODO`, `IN_PROGRESS` o `CLOSED` |
| report.reportedByCustomer | boolean | Indica si tu organización envió el reporte |
| report.slaDueAt | string \| null | Fecha límite del SLA para el reporte. `null` cuando no aplica ningún SLA |
| report.duplicateOfId | number \| null | ID del reporte del que este es un duplicado. `null` cuando no es un duplicado |
| report.createdAt / report.updatedAt | string | Marcas de tiempo ISO 8601 |
| report.assets | array | Cada asset del reporte, del más antiguo al más reciente |
| report.assets\[].proposalId | number | La **Proposal** (propuesta para bloquear o permitir un asset) de este asset en este reporte |
| report.assets\[].reviewStatus | string | La revisión de ChainPatrol de este asset en este reporte: `PENDING`, `APPROVED` o `REJECTED` |
| report.assets\[].asset.id | number | El ID del asset |
| report.assets\[].asset.type | string | El tipo de asset, por ejemplo `URL`, `TWITTER` o `ADDRESS` |
| report.assets\[].asset.content | string | El asset en sí: la URL, el handle o la dirección |
| report.assets\[].asset.status | string | El estado actual del asset: `BLOCKED`, `ALLOWED` o `UNKNOWN` |
| report.assets\[].asset.livenessStatus | string | Indica si el asset seguía online la última vez que se verificó: `ALIVE`, `DEAD` o `UNKNOWN` |
| report.assets\[].takedown | object \| null | El takedown de tu organización para este asset. `null` cuando no se inició ninguno |
| report.assets\[].takedown.status | string | `TODO`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED`, `PENDING_INPUT`, `PENDING_EVIDENCE`, `PENDING_RETRACTION`, `RETRACTION_SENT` o `RETRACTED` |
| report.assets\[].takedown.createdAt / updatedAt | string | Cuándo empezó el takedown y cuándo cambió por última vez |

## Respuestas de error

### 401 Unauthorized

La clave de API falta o no es válida:

```json theme={null}
{
  "message": "Authentication required. Provide API key or valid session.",
  "code": "UNAUTHORIZED"
}
```

### 403 Forbidden

Pasaste un `slug` de una organización a la que tus credenciales no tienen acceso.

### 404 Not Found

Ningún reporte con este ID pertenece a tu organización, ya sea porque no existe o porque pertenece a otra organización:

```json theme={null}
{
  "message": "Report not found",
  "code": "NOT_FOUND"
}
```

## Casos de uso

### ¿Por qué esto sigue activo?

Un asset que está `BLOCKED` ya está en la **Blocklist** (lista de bloqueo) de ChainPatrol, así que las wallets y los navegadores que la usan advierten a las personas. Que esté offline es un paso aparte: el takedown ante el proveedor de hosting o la plataforma del sitio. Lee los dos datos en conjunto:

```typescript theme={null}
const { report } = await response.json();

for (const { asset, takedown } of report.assets) {
  if (asset.livenessStatus === "ALIVE") {
    console.log(
      `${asset.content} is ${asset.status} and still online; takedown: ${takedown?.status ?? "not started"}`
    );
  }
}
```

## Notas

* El takedown que se muestra es el de tu organización. No se incluye un takedown que otra organización haya presentado sobre el mismo asset.
* `livenessStatus` corresponde a la última verificación, no a una solicitud en tiempo real.
* Todas las marcas de tiempo están en formato ISO 8601 y en UTC.


## OpenAPI

````yaml GET /organization/reports/{reportId}
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/{reportId}:
    get:
      tags:
        - organization
      summary: Get one organization report
      description: >-
        Answers 'what happened to this report?'. Takes a report ID, for example
        from a report link (app.chainpatrol.io/admin/<slug>/reports/<reportId>),
        and returns the report, how many evidence files are attached to it, and
        each of its assets: ChainPatrol's review, the asset's status and whether
        it was still online when last checked, and your organization's takedown
        of it. Only your organization's reports: any other ID returns 404. To
        find reports by filters instead, use `GET /organization/reports`.
      operationId: organizationReportsGet
      parameters:
        - in: path
          name: reportId
          description: >-
            The report's ID, as in its link:
            app.chainpatrol.io/admin/<slug>/reports/<reportId>
          schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            description: >-
              The report's ID, as in its link:
              app.chainpatrol.io/admin/<slug>/reports/<reportId>
          required: true
        - in: query
          name: slug
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  report:
                    type: object
                    properties:
                      id:
                        type: number
                      title:
                        type: string
                      description:
                        type: string
                      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.
                      duplicateOfId:
                        type: number
                        nullable: true
                        description: >-
                          ID of the report this one duplicates. `null` when it
                          isn't a duplicate.
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                      attachmentCount:
                        type: integer
                        description: >-
                          How many files (screenshots, emails and other
                          evidence) are attached to the report. Removed files
                          are not counted.
                      assets:
                        type: array
                        items:
                          type: object
                          properties:
                            proposalId:
                              type: number
                            reviewStatus:
                              type: string
                              enum:
                                - PENDING
                                - APPROVED
                                - REJECTED
                              description: >-
                                ChainPatrol's review of this asset in this
                                report
                            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
                                  description: >-
                                    The asset's status now: `BLOCKED`, `ALLOWED`
                                    or `UNKNOWN`
                                livenessStatus:
                                  type: string
                                  enum:
                                    - UNKNOWN
                                    - ALIVE
                                    - DEAD
                                  description: >-
                                    Whether the asset was still online when last
                                    checked
                              required:
                                - id
                                - type
                                - content
                                - status
                                - livenessStatus
                            takedown:
                              type: object
                              nullable: true
                              properties:
                                id:
                                  type: number
                                status:
                                  type: string
                                  enum:
                                    - TODO
                                    - IN_PROGRESS
                                    - COMPLETED
                                    - CANCELLED
                                    - PENDING_RETRACTION
                                    - RETRACTION_SENT
                                    - RETRACTED
                                    - PENDING_INPUT
                                    - PENDING_EVIDENCE
                                createdAt:
                                  type: string
                                updatedAt:
                                  type: string
                              required:
                                - id
                                - status
                                - createdAt
                                - updatedAt
                              description: >-
                                Your organization's takedown of this asset.
                                `null` when none was started.
                          required:
                            - proposalId
                            - reviewStatus
                            - asset
                            - takedown
                        description: Each asset in the report, oldest proposal first
                    required:
                      - id
                      - title
                      - description
                      - status
                      - reportedByCustomer
                      - slaDueAt
                      - duplicateOfId
                      - createdAt
                      - updatedAt
                      - attachmentCount
                      - assets
                required:
                  - report
                description: Successful operation
        '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.