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

## 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,isNetworkChipAuthentication,isInternationalTransaction,foreignExchangeFees,crossBorderFees,merchantCountryCode,ledgerSettlementAmount,postedAt,tenantId,billingTenantId
123456789-123456789-123456789,2026-02-14T11:59:40.665Z,spend,closed,PAYPAL,8299,63,usd,63,usd,13860,987654321-987654321-987654321,5618,John Doe,false,false,false,Classic,1234567890,,false,false,0,0,US,63,2026-02-14T11:59:40.665Z,11111111-1111-1111-1111-111111111111,11111111-1111-1111-1111-111111111111
```


## OpenAPI

````yaml get /issuing/reports/{year}/{month}/{day}
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}/{day}:
    get:
      tags:
        - reports
      summary: Get a tenant's report
      operationId: getIssuingTenantReport
      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
          required: true
          schema:
            type: string
            pattern: ^\d{2}$
        - name: day
          in: path
          description: Day of the report
          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
          description: >-
            Whether to include subtenant data in the report. When true, returns
            combined data from tenant and all subtenants. When false or omitted,
            returns only the tenant's direct data. Subtenants automatically
            receive subtenant-specific reports.
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Successful operation
          content:
            text/csv:
              schema:
                type: string
                description: The report for the given day
              example: >-
                transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,fxFee,cardId,cardLast4,cardholder,isThreeDSecureTransaction,isATMTransaction,isATMPremiumTransaction,visaProductType,tokenRequestorId,walletName,isNetworkAccountVerification,isNetworkChipAuthentication,isInternationalTransaction

                123456789-123456789-123456789,2026-02-14T11:59:40.665Z,spend,closed,PAYPAL,8299,63,usd,63,usd,13860,0,987654321-987654321-987654321,5618,John
                Doe,false,false,false,Classic,1234567890,,false,false,false
            application/json:
              schema:
                type: string
                description: The report for the given day
              example: >-
                transactionId,transactionDate,transactionType,status,merchantName,merchantCategoryCode,authorizationAmount,authorizationCurrency,settlementAmount,settlementCurrency,interchangeAmount,fxFee,cardId,cardLast4,cardholder,isThreeDSecureTransaction,isATMTransaction,isATMPremiumTransaction,visaProductType,tokenRequestorId,walletName,isNetworkAccountVerification,isNetworkChipAuthentication,isInternationalTransaction

                123456789-123456789-123456789,2026-02-14T11:59:40.665Z,spend,closed,PAYPAL,8299,63,usd,63,usd,13860,0,987654321-987654321-987654321,5618,John
                Doe,false,false,false,Classic,1234567890,,false,false,false
            application/zip:
              schema:
                type: string
                format: binary
                description: The report for the given day
        '401':
          description: Invalid authorization
        '404':
          description: Transaction not found
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Api-Key
      in: header

````