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

# Get Client Details

> Retrieves comprehensive details for a single client, including subscription, usage metrics, assigned campaigns, and form submissions.

## Authentication
All requests require an `Authorization` header using Bearer token authentication:
`Authorization: Bearer <api_key>`



## OpenAPI

````yaml GET /api/v2/clients/{client_id}
openapi: 3.1.0
info:
  title: VoiceAIWrapper API
  description: >-
    REST API for managing campaigns, leads, clients, web widgets, and voice
    providers on VoiceAIWrapper.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.voiceaiwrapper.app
security:
  - bearerAuth: []
paths:
  /api/v2/clients/{client_id}:
    get:
      tags:
        - Clients
      summary: Get Client Details
      description: >-
        Retrieves comprehensive details for a single client, including
        subscription, usage metrics, assigned campaigns, and form submissions.


        ## Authentication

        All requests require an `Authorization` header using Bearer token
        authentication:

        `Authorization: Bearer <api_key>`
      operationId: getClientDetails
      parameters:
        - name: client_id
          in: path
          required: true
          description: Global ID (or raw ID) of the client. Required.
          schema:
            type: string
            example: Q2xpZW50OjEyMw==
      responses:
        '200':
          description: >-
            Client details retrieved successfully. Returns client info,
            subscription, usage, campaigns, and form submissions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  client:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      primary_email:
                        type: string
                      created_at:
                        type: string
                        format: date-time
                      users:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            email:
                              type: string
                  subscription:
                    type: object
                    nullable: true
                    properties:
                      id:
                        type: string
                      stripe_id:
                        type: string
                      status:
                        type: string
                      created_at:
                        type: string
                        format: date-time
                      product:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          pricing_model:
                            type: string
                      pricing_details:
                        type: object
                        properties:
                          pricing_model:
                            type: string
                          prices:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                stripe_price_id:
                                  type: string
                                billing_type:
                                  type: string
                                usage_type:
                                  type: string
                                unit_amount:
                                  type:
                                    - number
                                    - 'null'
                                currency:
                                  type: string
                                interval:
                                  type: string
                                active:
                                  type: boolean
                          currency:
                            type: string
                          interval:
                            type: string
                          subscription_price:
                            type: number
                          subscription_price_formatted:
                            type: string
                          usage_price_tiers:
                            type: array
                            items:
                              type: object
                              properties:
                                up_to:
                                  type:
                                    - number
                                    - 'null'
                                flat_amount:
                                  type:
                                    - number
                                    - 'null'
                                unit_amount:
                                  type:
                                    - number
                                    - 'null'
                                flat_amount_decimal:
                                  type:
                                    - string
                                    - 'null'
                                unit_amount_decimal:
                                  type: string
                          min_minutes_included:
                            type: number
                          additional_minute_price:
                            type: number
                          additional_minute_price_formatted:
                            type: string
                      trial:
                        type: object
                        properties:
                          trial_type:
                            type: string
                          trial_days:
                            type: integer
                          trial_minutes:
                            type: integer
                          trial_end:
                            type:
                              - string
                              - 'null'
                          trial_start:
                            type: integer
                          trial_minutes_assigned:
                            type: integer
                          trial_minutes_used:
                            type: integer
                      billing_cycle:
                        type: object
                        properties:
                          current_period_start:
                            type:
                              - string
                              - 'null'
                          current_period_end:
                            type:
                              - string
                              - 'null'
                          billing_cycle_anchor:
                            type: integer
                          created:
                            type: integer
                  usage:
                    type: object
                    nullable: true
                    properties:
                      source:
                        type: string
                      minutes_used:
                        type: number
                      billing_period_start:
                        type: integer
                      billing_period_end:
                        type: integer
                      meter_id:
                        type: string
                  campaigns:
                    type: object
                    properties:
                      total_campaigns:
                        type: integer
                      total_leads:
                        type: integer
                      total_calls:
                        type: integer
                      campaigns:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            type:
                              type: string
                            status:
                              type: string
                            web_widget_enabled:
                              type:
                                - boolean
                                - 'null'
                            leads_count:
                              type: integer
                            calls_count:
                              type: integer
                            success_metrics:
                              type:
                                - object
                                - 'null'
                            success_evaluation_frequency:
                              type: array
                              items:
                                type: object
                                properties:
                                  status:
                                    type: string
                                  count:
                                    type: integer
                                  percentage:
                                    type: number
                  form_submissions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        form_id:
                          type: string
                        form_title:
                          type: string
                        submitted_at:
                          type: string
                          format: date-time
                        response_data:
                          type: object
                          additionalProperties: true
                        is_test:
                          type: boolean
        '400':
          description: Invalid request data. The client_id path parameter is missing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              example:
                message: Client ID is required
        '401':
          description: Authentication failed. Ensure the Bearer token is present and valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '404':
          description: >-
            Resource not found. The client_id does not exist or does not belong
            to your tenant.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              example:
                message: Client not found
        '500':
          description: Internal server error. Contact support if this persists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
components:
  schemas:
    ErrorMessage:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````