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

# Get Provider Breakdown

> View costs and metrics split by underlying AI and telecom providers.

Fetches a breakdown of the models and services used by your voice agents. The response separates your metrics into groups like `llm`, `tts`, and `stt`, helping you identify which specific providers (e.g., OpenAI, Anthropic, ElevenLabs) are driving your costs.

### Query Parameters

<ParamField query="start_date" type="string">
  Start date in `YYYY-MM-DD` format. Defaults to 30 days ago.
</ParamField>

<ParamField query="end_date" type="string">
  End date in `YYYY-MM-DD` format. Defaults to today.
</ParamField>

<ParamField query="start_datetime" type="string">
  Start exact time in ISO 8601 format (e.g. `2024-03-01T14:30:00Z`). Overrides `start_date`.
</ParamField>

<ParamField query="end_datetime" type="string">
  End exact time in ISO 8601 format. Overrides `end_date`.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="period" type="object">
      The start and end boundaries of the query.
    </ResponseField>

    <ResponseField name="providers" type="object">
      A dictionary where keys are component types (e.g., `llm`, `tts`, `stt`) and values are lists of provider metrics.

      <Expandable title="items">
        <ResponseField name="provider" type="string">
          The name of the service provider (e.g., `openai`, `elevenlabs`).
        </ResponseField>

        <ResponseField name="call_count" type="integer">
          Number of calls that used this provider.
        </ResponseField>

        <ResponseField name="total_cost_credits" type="number">
          Platform credits consumed by this provider.
        </ResponseField>

        <ResponseField name="avg_duration_seconds" type="number">
          Average duration of calls in seconds for this provider.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>
