---
title: "Get AI function usage breakdown by source"
method: GET
path: "/api/v1/databricks/ai-ml-services/endpoints/{endpoint_name}/usage-breakdown"
tags: ["DATABRICKS", "Databricks", "Databricks AI/ML Services"]
---

# Get AI function usage breakdown by source

`GET /api/v1/databricks/ai-ml-services/endpoints/{endpoint_name}/usage-breakdown`

Get usage breakdown for an AI function endpoint.

Shows how the AI function is being invoked: via MV refresh, notebooks,
jobs, SQL queries, DDL, or ad-hoc queries.

Path Parameters:
- endpoint_name: AI function endpoint name (e.g., databricks-ai-summarize)

Query Parameters:
- start_date: Start date (YYYY-MM-DD), defaults to 30 days ago
- end_date: End date (YYYY-MM-DD), defaults to today

Returns:
- usage: List of usage sources with type, identity, request count, and last used

## Path parameters

- `endpoint_name` string, required

## Query parameters

- `start_date` string, date, nullable — Start date (YYYY-MM-DD), defaults to 30 days ago
- `end_date` string, date, nullable — End date (YYYY-MM-DD), defaults to today
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- AIFunctionUsageBreakdownResponse — Response for AI function usage breakdown.
  - `usage` AIFunctionUsageItem[] — List of usage sources
    - `usage_type` string, required — Type of usage: 'MV Refresh', 'Notebook', 'SQL Query', 'Job', 'DDL', 'Ad-hoc'
    - `usage_identity` string, required — Identity of the usage source: MV name, notebook ID, job ID, etc.
    - `job_name` string, nullable — Resolved job name from dbx_job_inventory (for Job type)
    - `executed_by` string, nullable — User who executed the query
    - `source_identifier` string, nullable — Best available identifier: statement_id, job_id, notebook_id, etc.
    - `total_requests` integer — Total number of invocations
    - `days_active` integer — Number of distinct days with activity
    - `last_used` string, nullable — Most recent invocation timestamp

## Other responses

- `403` — Not authorized
- `404` — Resource not found
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/50769cbf05d5/schema)