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

# Explain Portfolio

> Generate AI-powered portfolio insights for a residual period. Rate limited to 5 req/min.



## OpenAPI

````yaml POST /api/partner/residuals/explain
openapi: 3.0.3
info:
  title: Partner API
  description: External API for ISO partners to access merchant data, pricing, and reports
  version: 0.1.0
servers: []
security: []
paths:
  /api/partner/residuals/explain:
    post:
      tags:
        - Residuals
        - Residuals
      summary: AI portfolio insights
      description: >-
        Generate AI-powered portfolio insights for a residual period. Rate
        limited to 5 req/min.
      operationId: explain_portfolio_endpoint_api_partner_residuals_explain_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '401':
          description: Missing or invalid API key
        '404':
          description: No residual data for the specified period
        '422':
          description: Invalid request body
        '429':
          description: 'Rate limit exceeded (AI sub-limit: 5/min)'
        '503':
          description: AI insights service unavailable

````