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

# List compliance reports

> Retrieves compliance reports filtered by project, period, and country. Reports are auto-generated documents required by regulators.

## Supported countries

| Code | Country     |
| ---- | ----------- |
| `MX` | México      |
| `CO` | Colombia    |
| `SV` | El Salvador |
| `GT` | Guatemala   |

## Query parameters

| Parameter     | Type    | Required | Description                   |
| ------------- | ------- | -------- | ----------------------------- |
| `projectId`   | integer | yes      | Your project ID               |
| `period`      | string  | yes      | Period in `YYYY-MM` format    |
| `countryCode` | string  | yes      | One of `MX`, `CO`, `SV`, `GT` |
| `limit`       | integer | no       | Max results (default: 10)     |
| `offset`      | integer | no       | Pagination offset             |
| `search`      | string  | no       | Filter by report name         |

<Tip>
  Reports are generated automatically based on your project's transaction activity and the regulatory requirements of each jurisdiction.
</Tip>


## OpenAPI

````yaml GET /reports
openapi: 3.1.0
info:
  title: Wavy Node API
  description: >-
    Compliance, fraud prevention, and risk analysis API for payment providers
    and cryptocurrency exchanges in Latin America.
  version: 1.0.0
  contact:
    name: Wavy Node Support
    email: support@wavynode.com
servers:
  - url: https://api.wavynode.com/v1
    description: Production
security:
  - apiKeyAuth: []
paths:
  /reports:
    get:
      tags:
        - Reports
      summary: List compliance reports
      description: >-
        Retrieves compliance reports filtered by project, period, and country.
        Reports are auto-generated documents required by regulators in supported
        jurisdictions (MX, CO, SV, GT).
      operationId: listReports
      parameters:
        - name: projectId
          in: query
          required: true
          description: The project ID
          schema:
            type: integer
        - name: period
          in: query
          required: true
          description: Report period in YYYY-MM format
          schema:
            type: string
            pattern: ^\d{4}-\d{2}$
        - name: countryCode
          in: query
          required: true
          description: Country code for regulatory jurisdiction
          schema:
            type: string
            enum:
              - MX
              - CO
              - SV
              - GT
        - name: limit
          in: query
          required: false
          description: 'Maximum number of reports to return (default: 10)'
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          required: false
          description: Pagination offset
          schema:
            type: integer
            default: 0
        - name: search
          in: query
          required: false
          description: Search term to filter reports by name
          schema:
            type: string
      responses:
        '200':
          description: List of compliance reports
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Report'
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No reports found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Report:
      type: object
      properties:
        id:
          type: string
          description: Report ID
        name:
          type: string
          description: Report name
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Error code
        message:
          type: string
          description: Error description
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Enter the full value with the `ApiKey` prefix. Example: `ApiKey
        wavy_your-api-key`. The prefix is required for authentication.

````