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

# Retrieve reporting summary

> Requires `reporting:read`. 



## OpenAPI

````yaml /openapi.json get /reporting/summary
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /reporting/summary:
    get:
      tags:
        - Reporting
      summary: Retrieve reporting summary
      description: 'Requires `reporting:read`. '
      operationId: m2mGetReportingSummary
      parameters:
        - name: range
          in: query
          schema:
            type: string
            enum:
              - last_7d
              - last_30d
              - this_month
              - last_month
              - custom
            default: last_7d
          description: ''
        - name: start
          in: query
          schema:
            type: string
            format: date
          description: >-
            Tenant-local date; required with range=custom. Maximum 366 inclusive
            days.
        - name: end
          in: query
          schema:
            type: string
            format: date
          description: >-
            Tenant-local date; required with range=custom. Maximum 366 inclusive
            days.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportingSummary'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    ReportingSummary:
      type: object
      properties:
        asOf:
          type: string
        range:
          type: string
        timezone:
          type: string
        window:
          type: object
          properties:
            start:
              type: string
            end:
              type: string
            startInclusive:
              type: string
            endExclusive:
              type: string
        metrics:
          type: object
          properties:
            totalMessages:
              type: integer
            inboundMessages:
              type: integer
            outboundMessages:
              type: integer
            uniqueConversations:
              type: integer
        daily:
          type: array
          items:
            type: object
        channels:
          type: array
          items:
            type: object
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````