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

# Get Engage usage per tenant

> Returns every tenant using Engage — one that finished the Engage onboarding wizard, has sent a message, has created a broadcast or has an active automation, or has an SMS number — ranked by total sends. Email and SMS send counts cover the optional date range (startDate, endDate); active automation and SMS number counts are current state.



## OpenAPI

````yaml GET /partner/engage/tenants
openapi: 3.0.0
info:
  title: Reach API
  version: 1.0.0
  description: API documentation for Reach platform
servers:
  - url: https://api.embedreach.com
    description: Production server
security: []
paths:
  /partner/engage/tenants:
    get:
      tags:
        - Partner Engage
      summary: Get Engage usage per tenant
      description: >-
        Returns every tenant using Engage — one that finished the Engage
        onboarding wizard, has sent a message, has created a broadcast or has an
        active automation, or has an SMS number — ranked by total sends. Email
        and SMS send counts cover the optional date range (startDate, endDate);
        active automation and SMS number counts are current state.
      parameters:
        - schema:
            type: string
          required: false
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 100
            default: 25
          required: false
          name: limit
          in: query
        - schema:
            type: string
            nullable: true
          required: false
          name: startDate
          in: query
        - schema:
            type: string
            nullable: true
          required: false
          name: endDate
          in: query
      responses:
        '200':
          description: Status 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            tenantId:
                              type: string
                            tenantExternalId:
                              type: string
                              nullable: true
                            tenantName:
                              type: string
                            emailsSent:
                              type: number
                            smsSent:
                              type: number
                            totalSends:
                              type: number
                            activeAutomations:
                              type: number
                            smsNumberCount:
                              type: number
                          required:
                            - tenantId
                            - tenantExternalId
                            - tenantName
                            - emailsSent
                            - smsSent
                            - totalSends
                            - activeAutomations
                            - smsNumberCount
                      pagination:
                        type: object
                        properties:
                          hasNextPage:
                            type: boolean
                          cursor:
                            type: string
                            nullable: true
                          total:
                            type: number
                        required:
                          - hasNextPage
                    required:
                      - results
                      - pagination
                required:
                  - success
        '400':
          description: Bad Request - Validation or request error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    default: false
                  message:
                    type: string
                    description: Error message describing what went wrong
                  errors:
                    type: array
                    items:
                      type: string
                    description: Optional array of specific validation errors
                required:
                  - message

````