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

# Get Aimee performance overview

> Retrieve Aimee Overview Statistics.

**Sample Request:**
```
GET /api/aimee-overview-stats/?practice_ids=9AxAFr4n63uputNXKo89x1,9AxAFr4n63uputNXKo89x2&organization_id=9AxAFr4n63uputNXKo89x1&region_id=9AxAFr4n63uputNXKo89x1&custom_filter=aimee_booked
```



## OpenAPI

````yaml /openapi/peerlogic-api.json get /api/aimee-overview-stats/
openapi: 3.1.0
info:
  title: Peerlogic API
  version: 1.0.0
  description: >-
    Customer-facing API reference for accessing Peerlogic calls, insights,
    conversations, tasks, opportunities, subscriptions, and events.
servers:
  - url: https://api.prod.peerlogic.com
    description: Production
security: []
tags:
  - name: Authentication
    description: Obtain an access token for authenticated API requests.
  - name: Call insights
    description: Call records and aggregate performance insights.
  - name: Transcripts
    description: Transcripts, summaries, sentiment, pauses, and call-purpose details.
  - name: Aimee
    description: Aimee activity, configuration, and performance insights.
  - name: Conversations
    description: Conversation records, messages, and conversation actions.
  - name: Tasks
    description: Customer tasks and task workflow actions.
  - name: Opportunities
    description: Opportunities and follow-up reporting.
  - name: Subscriptions and events
    description: >-
      Create and manage event subscriptions, then inspect event records and
      analytics. For the complete webhook delivery flow, see the Webhooks and
      subscriptions guide.
  - name: Organizations and practices
    description: >-
      Discover the organizations and practices available to the authenticated
      account.
  - name: Contacts and patients
    description: Find contacts and patients for caller recognition and related workflows.
  - name: Appointments
    description: Retrieve appointment history and upcoming appointments for a patient.
  - name: Messaging
    description: Send practice messages, including missed-call recovery outreach.
  - name: Call recordings
    description: Retrieve recording metadata and secure audio URLs for calls.
paths:
  /api/aimee-overview-stats/:
    parameters: []
    get:
      tags:
        - Aimee
      summary: Get Aimee performance overview
      description: >-
        Retrieve Aimee Overview Statistics.


        **Sample Request:**

        ```

        GET
        /api/aimee-overview-stats/?practice_ids=9AxAFr4n63uputNXKo89x1,9AxAFr4n63uputNXKo89x2&organization_id=9AxAFr4n63uputNXKo89x1&region_id=9AxAFr4n63uputNXKo89x1&custom_filter=aimee_booked

        ```
      operationId: aimee-overview-stats_list
      parameters:
        - name: practice_ids
          in: query
          description: >-
            Comma-separated list of practice IDs to filter statistics by
            specific practices. Example:
            '9AxAFr4n63uputNXKo89x1,9AxAFr4n63uputNXKo89x2'
          required: false
          schema:
            type: string
        - name: organization_id
          in: query
          description: >-
            Organization ID to filter statistics within a specific organization.
            Example: '9AxAFr4n63uputNXKo89x1'
          required: false
          schema:
            type: string
        - name: region_id
          in: query
          description: >-
            Region ID to filter statistics by a specific region. Example:
            '9AxAFr4n63uputNXKo89x1'
          required: false
          schema:
            type: string
        - name: search
          in: query
          description: >-
            Search term to filter conversations by message content. Example:
            'follow-up'
          required: false
          schema:
            type: string
        - name: caller_name
          in: query
          description: 'Filter conversations by caller name. Example: ''John Doe'''
          required: false
          schema:
            type: string
        - name: start_time
          in: query
          description: 'Filter conversations by start time. Example: ''2024-09-25T08:00:00Z'''
          required: false
          schema:
            type: string
        - name: non_practice_participant_type
          in: query
          description: >-
            Filter conversations by non-practice participant type. Example:
            'new_patient'.
          required: false
          schema:
            type: string
            enum:
              - new_patient
              - existing_patient
        - name: custom_filter
          in: query
          description: 'Apply custom filters to conversations. Example: ''aimee_booked''.'
          required: false
          schema:
            type: string
            enum:
              - all_conversations
              - patients_engaged
              - action_required
              - aimee_booked
              - aimee_rescheduled
              - aimee_cancelled
              - aimee_confirmed
              - staff_intervened
              - staff_booked
              - staff_rescheduled
              - staff_cancelled
              - staff_confirmed
      responses:
        '200':
          description: Aimee overview statistics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversations_initiated:
                    type: integer
                  patients_engaged:
                    type: integer
                  booked_revenue:
                    type: number
                  booked_opportunities:
                    type: integer
                  booked_opportunities_percentage:
                    type: number
                  rescheduled_opportunities:
                    type: integer
                  rescheduled_opportunities_percentage:
                    type: number
                  cancelled_opportunities:
                    type: integer
                  cancelled_opportunities_percentage:
                    type: number
                  staff_intervened_opportunities:
                    type: integer
                  staff_intervened_opportunities_percentage:
                    type: number
                  escalated_opportunities:
                    type: integer
                  escalated_opportunities_percentage:
                    type: number
                  total_hand_offs:
                    type: integer
              examples:
                response:
                  value:
                    conversations_initiated: 554
                    patients_engaged: 49
                    booked_revenue: 0
                    booked_opportunities: 1
                    booked_opportunities_percentage: 0.18
                    rescheduled_opportunities: 0
                    rescheduled_opportunities_percentage: 0
                    cancelled_opportunities: 0
                    cancelled_opportunities_percentage: 0
                    staff_intervened_opportunities: 0
                    staff_intervened_opportunities_percentage: 0
                    escalated_opportunities: 454
                    escalated_opportunities_percentage: 81.95
                    total_hand_offs: 500
        '400':
          description: Bad Request - Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              example:
                field_error: >-
                  One of the following parameter must be provided [practice_ids,
                  organization_id or region_id]
        '401':
          description: Authentication is required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationError'
              example:
                detail: '''Authorization'' header is required'
      security:
        - bearerAuth: []
components:
  schemas:
    ValidationError:
      title: Validation error
      type: object
      additionalProperties: true
      description: Validation details keyed by the invalid field or grouped under `errors`.
    AuthenticationError:
      title: Authentication error
      type: object
      additionalProperties: true
      required:
        - detail
      properties:
        detail:
          type: string
          description: Why authentication failed.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer access token issued by Peerlogic.

````

## Related topics

- [Get Aimee revenue overview](/peerlogic-api-reference/aimee/get-aimee-revenue-overview.md)
- [Get Aimee performance by practice](/peerlogic-api-reference/aimee/get-aimee-performance-by-practice.md)
- [Get task performance overview](/peerlogic-api-reference/tasks/get-task-performance-overview.md)
- [Get opportunity performance overview](/peerlogic-api-reference/call-insights/get-opportunity-performance-overview.md)
- [Get Aimee action-required reasons](/peerlogic-api-reference/aimee/get-aimee-action-required-reasons.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.