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

# Get capacity-adjusted booking rates

> Requires read:calls and capacity-adjusted booking enabled for the requested team. Uses the default call-type scope and excludes standard non-actionable reasons. Time Concern uses the recorded unbooked classification, including subsequently recovered calls; rates can exceed 100%. Maximum 31 days and 10 requests per minute. See the capacity-adjusted booking guide for formulas and exports.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/teams/{teamId}/call-analytics/capacity-adjusted-booking
openapi: 3.1.0
info:
  title: Avoca Enterprise API
  description: >-
    Read-only programmatic access to Avoca data: calls and recordings,
    transcripts, leads, coach evaluations, Simple Scheduler sessions and
    analytics, outbound texting activity, and enterprise support tickets.
  version: 1.4.0
servers:
  - url: https://enterprise-api.avoca.ai
security:
  - bearerAuth: []
tags:
  - name: Calls
    description: Call records, recordings, transcripts, and pre-call transfers
  - name: Leads
    description: Unified leads (v0) and the canonical leads feed (v1)
  - name: Teams
    description: Teams accessible to the API key
  - name: Coach
    description: Coach (QA) call evaluations and rubrics
  - name: Scheduler Analytics (v0)
    description: Simple Scheduler analytics — legacy flat endpoints
  - name: Sessions & Bookings
    description: v1 scheduling-widget sessions and completed bookings
  - name: Analytics (v1)
    description: v1 funnel, UTM, service-area, and issue-type analytics
  - name: Outbound Texting
    description: Campaign text and subscription-event feeds for BI ingestion
  - name: Support Tickets
    description: Customer-safe enterprise support-ticket feed
paths:
  /api/v1/teams/{teamId}/call-analytics/capacity-adjusted-booking:
    get:
      tags:
        - Calls
      summary: Get capacity-adjusted booking rates
      description: >-
        Requires read:calls and capacity-adjusted booking enabled for the
        requested team. Uses the default call-type scope and excludes standard
        non-actionable reasons. Time Concern uses the recorded unbooked
        classification, including subsequently recovered calls; rates can exceed
        100%. Maximum 31 days and 10 requests per minute. See the
        capacity-adjusted booking guide for formulas and exports.
      operationId: getCapacityAdjustedBookingRates
      parameters:
        - name: teamId
          in: path
          required: true
          schema:
            type: integer
            minimum: 1
        - name: dateFrom
          in: query
          required: true
          schema:
            type: string
            format: date-time
        - name: dateTo
          in: query
          required: true
          schema:
            type: string
            format: date-time
        - name: format
          in: query
          schema:
            type: string
            enum:
              - json
              - csv
            default: json
      responses:
        '200':
          description: >-
            Counts and percentage rates for the selected period. CSV has
            matching column names and blank cells for null rates.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - totalCalls
                      - bookableCalls
                      - bookedCalls
                      - recoveredCalls
                      - unbookedTimeConcernCalls
                      - fullyRecoveredBookingRate
                      - rawRecoveredBookingRate
                    properties:
                      totalCalls:
                        type: integer
                        minimum: 0
                      bookableCalls:
                        type: integer
                        minimum: 0
                      bookedCalls:
                        type: integer
                        minimum: 0
                      recoveredCalls:
                        type: integer
                        minimum: 0
                      unbookedTimeConcernCalls:
                        type: integer
                        minimum: 0
                      fullyRecoveredBookingRate:
                        type:
                          - number
                          - 'null'
                        description: >-
                          (bookedCalls + recoveredCalls) / (bookableCalls -
                          unbookedTimeConcernCalls) * 100; null when denominator
                          is zero.
                      rawRecoveredBookingRate:
                        type:
                          - number
                          - 'null'
                        description: >-
                          (bookedCalls + recoveredCalls) / (totalCalls -
                          unbookedTimeConcernCalls) * 100; null when denominator
                          is zero.
            text/csv:
              schema:
                type: string
        '400':
          description: Invalid date range.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Feature disabled.
        '429':
          description: Too many requests.
        '503':
          description: Metrics unavailable.
      servers:
        - url: https://api.prod.avoca.ai
components:
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: API key lacks the required permission or team access
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type
        message:
          type: string
          description: Human-readable description (newer endpoints)
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key in the format `avoca_<64 hex characters>`

````