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

# Get tenant details

> Fetch one tenant by id. Returns the full detail object (adoption, policy, usage signals) for reporting and integrations. Not a list.



## OpenAPI

````yaml GET /beta/tenants/{tenantId}
openapi: 3.1.0
info:
  title: Longwave API
  version: 1.0.0
  description: >-
    Programmatic access to Longwave tenant and usage data. Use the dashboard to
    create API keys; authenticate with Bearer tokens.
  contact:
    name: Longwave Support
    email: support@longwavehq.com
servers:
  - url: https://api.longwavehq.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Tenants
    description: List and retrieve tenant metadata
  - name: Auditing
    description: Audit and activity history
paths:
  /beta/tenants/{tenantId}:
    get:
      tags:
        - Tenants
      summary: Get tenant details
      description: >-
        Returns **one** tenant by `tenantId` with the **full** detail object
        (adoption, policy, usage, metadata) for reports and automations. To
        discover ids or show a directory, use **Get tenant list** first.
      operationId: getTenantDetails
      parameters:
        - name: tenantId
          in: path
          required: true
          description: Longwave tenant id
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TenantDetail'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '404':
          description: Tenant not found or not accessible for this key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
components:
  schemas:
    TenantDetail:
      allOf:
        - $ref: '#/components/schemas/TenantSummary'
        - type: object
          properties:
            adoptionScore:
              type: number
              format: float
            activeUsers:
              type: integer
            totalInteractions7d:
              type: integer
            policyName:
              type: string
            dataProtectionEnabled:
              type: boolean
            lastReportedAt:
              type: string
              format: date-time
            metadata:
              type: object
              additionalProperties: true
              description: Optional fields for partner integrations and reporting tools
    ErrorBody:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
    TenantSummary:
      type: object
      properties:
        id:
          type: string
        displayName:
          type: string
        externalTenantId:
          type: string
          description: Microsoft or Google directory tenant id, when applicable
        status:
          type: string
          description: e.g. active, trial, paused
        onboardedAt:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: 'Send as `Authorization: Bearer <your api key>`'

````