> ## Documentation Index
> Fetch the complete documentation index at: https://rain-sandbox-trial.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a tenant's monthly report

> Retrieves the monthly report for the specified year and month

## Subtenants

Pass `includeSubtenants=true` to return a combined report covering the tenant and all of its subtenants. When the parameter is `false` or omitted, the report contains only the tenant's own data.

Subtenant API keys automatically receive a subtenant-specific report. You don't need to set `includeSubtenants`. The `includeSubtenants` parameter applies to the `csv` and `json` formats.

## Example Response

```csv theme={null}
transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,cardId,cardLast4,cardholder,isThreeDSecureTransaction,isATMTransaction,isATMPremiumTransaction,visaProductType,tokenRequestorId,walletName,isNetworkAccountVerification,isNetworkChipAuthentication,isInternationalTransaction,foreignExchangeFees,crossBorderFees,merchantCountryCode
123456789-123456789-123456789,2025-12-05T13:23:46.372Z,spend,closed,TARGET STORE #510   ,5310,2460,usd,2460,usd,492000,123456789123456789,8888,John Doe,false,false,false,Classic,1234567890,ApplePay,false,false,false,0,0,US
```


## OpenAPI

````yaml get /issuing/reports/{year}/{month}
openapi: 3.0.3
info:
  title: Issuing API
  description: This is the specification for Rain's Issuing API.
  termsOfService: https://www.rain.xyz/legal/authorized-user-terms
  contact:
    email: support@rain.xyz
  version: 1.3.0
servers:
  - url: https://api-dev.rain.xyz/v1
    description: Sandbox server
  - url: https://api.rain.xyz/v1
    description: Production server
security: []
tags:
  - name: paymentRoutes
    description: >-
      **Endpoint Migration:** The `/v1/automations` endpoints have been renamed
      to `/v1/payment-routes`. The old `/v1/automations` paths remain available
      as deprecated aliases during migration. Update your integrations to use
      `/v1/payment-routes` as the deprecated endpoints will be removed in a
      future release.
  - name: simulate
    description: >-
      Transaction simulation endpoints for testing integration flows in
      non-production environments. These endpoints let you trigger transaction
      events programmatically to automate integration tests and verify webhook
      handling without depending on external systems or staging real deposits.
      **Sandbox only** — all simulation endpoints return `404 Not Found` in
      production.
  - name: raindrops
    description: >-
      Rewards and points management endpoints. Custom API keys need
      `raindrops:read`/`raindrops:write` for general rewards endpoints and
      `raindrops-travel:read`/`raindrops-travel:write` for travel redemption
      endpoints.
    x-group: rewards
paths:
  /issuing/reports/{year}/{month}:
    get:
      tags:
        - reports
      summary: Get a tenant's monthly report
      description: Retrieves the monthly report for the specified year and month
      operationId: getIssuingTenantMonthlyReport
      parameters:
        - name: year
          in: path
          description: Year of the report
          required: true
          schema:
            type: string
            pattern: ^\d{4}$
        - name: month
          in: path
          description: >-
            Month of the report, will contain transactions settled in the
            previous month
          required: true
          schema:
            type: string
            pattern: ^\d{2}$
        - name: format
          in: query
          description: The format of the report
          required: false
          schema:
            type: string
            enum:
              - csv
              - json
        - name: includeSubtenants
          in: query
          required: false
          schema:
            type: boolean
          description: Include subtenant activity in the report.
      responses:
        '200':
          description: Successful operation
          content:
            text/csv:
              schema:
                type: string
                description: The report for the given month
              example: >-
                transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,fxFee,cardId,cardLast4,cardholder,tokenRequestorId,walletName

                123456789-123456789-123456789,2025-12-05T13:23:46.372Z,spend,closed,TARGET
                STORE #510  
                ,5310,2460,usd,2460,usd,492000,0,123456789123456789,8888,John
                Doe,1234567890,ApplePay
            application/json:
              schema:
                type: string
                description: The report for the given month
              example: >-
                transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,fxFee,cardId,cardLast4,cardholder,tokenRequestorId,walletName

                123456789-123456789-123456789,2025-12-05T13:23:46.372Z,spend,closed,TARGET
                STORE #510  
                ,5310,2460,usd,2460,usd,492000,0,123456789123456789,8888,John
                Doe,1234567890,ApplePay
            application/zip:
              schema:
                type: string
                format: binary
                description: The report for the given month
        '401':
          description: Invalid authorization
        '403':
          description: Forbidden
        '404':
          description: Report not found
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Api-Key
      in: header

````