---
title: "Get unified list of AI/ML endpoints (Model Serving + Vector Search + AI Gateway)"
method: GET
path: "/api/v1/databricks/ai-ml-services/endpoints"
tags: ["DATABRICKS", "Databricks", "Databricks AI/ML Services"]
---

# Get unified list of AI/ML endpoints (Model Serving + Vector Search + AI Gateway)

`GET /api/v1/databricks/ai-ml-services/endpoints`

Get a unified list of AI/ML endpoints for the dashboard table.

Each row carries:

- ``service`` — routing discriminator ('model_serving' | 'vector_search' |
  'ai_gateway'). Used by the FE to pick the detail page on row-click; **not**
  a filter input. The legacy ``service`` query param was intentionally
  dropped (commit ad00d32) — it is no longer read here, so a stray
  ``?service=...`` is ignored rather than filtering. Use ``entity_type``
  to narrow rows.
- ``entity_type`` — leaf type rendered in the Type column / filtered on
  via the ``entity_type`` query param.

Fields that don't apply to a row's service are null. Pagination is applied
over the merged result set so the top spenders surface first.

Query Parameters:

- entity_type: comma-separated leaf entity_type values (optional)
- endpoint_name: exact endpoint name(s), repeatable, any-of match (optional)
- start_date: Start date (YYYY-MM-DD), defaults to 30 days ago
- end_date: End date (YYYY-MM-DD), defaults to today
- workspace_id: Comma-separated workspace IDs or 'all' (default)
- limit: Max rows to return (default: 50, max: 1000)
- offset: Pagination offset (default: 0)
- sort_by: see above
- sort_order: 'asc' | 'desc' (default: 'desc')

## Query parameters

- `entity_type` string, nullable — Comma-separated leaf entity_types to filter the rows. One of FOUNDATION_MODEL, CUSTOM_MODEL, AI_FUNCTION, EXTERNAL_MODEL, FEATURE_SPEC, VECTOR_SEARCH, AI_GATEWAY. Omit to return all rows.
- `endpoint_name` string[], nullable — Exact endpoint name(s) to filter the rows (any-of match). Repeat the param for multiple names. Names are sourced from GET /ai-ml-services/endpoints/filters/names. Omit to return all rows.
- `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
- `workspace_id` string, nullable — Comma-separated workspace IDs to filter
- `limit` integer — Max rows to return
- `offset` integer — Pagination offset
- `sort_by` string — Sort field: 'endpoint_name' | 'total_cost_usd' | 'total_dbus' | 'service' | 'entity_type'
- `sort_order` string — Sort order: 'asc' or 'desc'
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- UnifiedAIMLEndpointsListResponse — Response for the unified AI/ML endpoints list.
  - `endpoints` UnifiedAIMLEndpointItem[] — Mixed list of model serving, vector search and AI gateway endpoints
    - `service` string, required — Routing discriminator: 'model_serving' | 'vector_search' | 'ai_gateway'
    - `entity_type` string, nullable — Leaf type used for the Type column / filter. One of the five model_serving entity types, 'VECTOR_SEARCH', or 'AI_GATEWAY'. Null when a model_serving endpoint has no served_entities row (rendered as '-' by the FE) — we don't guess a type.
    - `endpoint_name` string, required — Endpoint name
    - `endpoint_id` string, nullable — Endpoint ID
    - `total_dbus` number — Total DBUs consumed
    - `total_cost_usd` number — Total cost in USD
    - `created_by` string, nullable — Creator email (model_serving)
    - `total_requests` integer, nullable — Total requests (model_serving)
    - `total_tokens` integer, nullable — Total tokens (model_serving)
    - `unique_users` integer, nullable — Unique users (model_serving)
    - `days_active` integer, nullable — Days with activity (vector_search / ai_gateway)
    - `first_seen` string, nullable — First seen date (vector_search / ai_gateway)
    - `last_activity` string, nullable — Last activity date (vector_search / ai_gateway)
  - `pagination` AppSchemasDatabricksAiServicesPaginationInfo, required — Pagination information.
    - `total` integer, required — Total number of items
    - `limit` integer, required — Items per page
    - `offset` integer, required — Current offset

## 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/aab3fe5c9f05/schema)