Catalog - Search

Service:: Core

API Version:: v1

The Catalog Search API enables programmatic discovery of OneLake catalog entries across workspaces. It supports cross-workspace search over catalog metadata and returns results filtered to entries the calling principal is authorized to access. Search results include stable identifiers that are intended to be used with complementary Fabric APIs to retrieve additional details or perform supported actions.

Note

Catalog search is currently in Preview (learn more).

A CatalogEntry is a discoverable metadata representation of a Microsoft Fabric entity, currently scoped to workspace items. Catalog entries are intended for metadata discovery only and do not grant access to underlying data or item content.

Required Delegated Scopes

Catalog.Read.All

Microsoft Entra supported identities

This API supports the Microsoft identities listed in this section.

Identity	Support
User	Yes
Service principal and Managed identities	Yes

Limitations

The search functionality is currently scoped to specific Fabric item types. The following item types are not supported: Dashboard, Dataflow (Gen1), Dataflow (Gen2).

Interface

POST https://api.fabric.microsoft.com/v1/catalog/search

Request Body

Name	Type	Description
continuationToken	string	The continuationToken for the next page.
filter	string	The filter for the search. Currently the filter supports filter by type of entries. Additional filter options may be added over time. The filter parameter supports the following operators to refine results: eq : Equals; matches the exact value. ne : Not Equals; excludes the specified value. or : Logical OR; matches if any of the conditions are true. ( ) : Parentheses; groups expressions to define logical hierarchy.
pageSize	integer	The page size that needs to be returned. Page size must be between 1 and 1000.
search	string	The text query for the search. This field supports searching across the display name, workspace display name and description of the CatalogEntry.

Responses

Name Type Description

200 OK

Name	Type	Description
200 OK	CatalogQueryResponse	OK
429 Too Many Requests	ErrorResponse	The service rate limit was exceeded. The server returns a `Retry-After` header indicating, in seconds, how long the client must wait before sending additional requests. Headers Retry-After: integer
Other Status Codes	ErrorResponse	Common error codes: Unauthorized - Missing or invalid authentication Internal Server Error - Unexpected service failure.

CatalogQueryResponse

429 Too Many Requests

ErrorResponse

The service rate limit was exceeded. The server returns a Retry-After header indicating, in seconds, how long the client must wait before sending additional requests.

Headers

Retry-After: integer

Other Status Codes

ErrorResponse

Common error codes:

Unauthorized - Missing or invalid authentication
Internal Server Error - Unexpected service failure.

Examples

Search example

Sample request

HTTP

POST https://api.fabric.microsoft.com/v1/catalog/search

{
  "search": "Sales Revenue",
  "pageSize": 2,
  "filter": "Type eq 'Report' or Type eq 'Lakehouse'"
}

Sample response

Status code:: 200

{
  "value": [
    {
      "id": "0acd697c-1550-43cd-b998-91bfb12347c6",
      "type": "Report",
      "catalogEntryType": "FabricItem",
      "displayName": "Monthly Sales Revenue",
      "description": "Consolidated revenue report for the current fiscal year.",
      "hierarchy": {
        "workspace": {
          "id": "7f2c8a91-3b4d-4e5f-a6b7-c8d9e0f1a2b3",
          "displayName": "Sales Analytics"
        }
      }
    },
    {
      "id": "5e8f2a1b-9c3d-4e7f-b6a5-d4c3b2a1e0f9",
      "type": "Lakehouse",
      "catalogEntryType": "FabricItem",
      "displayName": "Sales Revenue Lakehouse",
      "description": "Central lakehouse for sales transaction data.",
      "hierarchy": {
        "workspace": {
          "id": "a2b3c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d",
          "displayName": "Finance Platform"
        }
      }
    }
  ],
  "continuationToken": "eyJza2lwIjoyLCJ0YWtl..."
}

Definitions

Name	Description
CatalogEntryType	The catalog entry type. Additional `CatalogEntryType` types may be added over time.
CatalogQueryRequest	The query for the search.
CatalogQueryResponse	The results of the search.
CatalogWorkspace	The workspace for the catalog entry.
ErrorRelatedResource	The error related resource details object.
ErrorResponse	The error response.
ErrorResponseDetails	The error response details.
ItemCatalogEntry	A Fabric item type of catalog entry.
ItemCatalogEntryHierarchy	The immediate ancestors of the item in Fabric's data architecture. Only applicable levels are returned.
ItemType	The type of the item. Additional item types may be added over time.

CatalogEntryType

Enumeration

The catalog entry type. Additional CatalogEntryType types may be added over time.

Value	Description
FabricItem	A Fabric item catalog entry type.

CatalogQueryRequest

Object

The query for the search.

Name	Type	Description
continuationToken	string	The continuationToken for the next page.
filter	string	The filter for the search. Currently the filter supports filter by type of entries. Additional filter options may be added over time. The filter parameter supports the following operators to refine results: eq : Equals; matches the exact value. ne : Not Equals; excludes the specified value. or : Logical OR; matches if any of the conditions are true. ( ) : Parentheses; groups expressions to define logical hierarchy.
pageSize	integer	The page size that needs to be returned. Page size must be between 1 and 1000.
search	string	The text query for the search. This field supports searching across the display name, workspace display name and description of the CatalogEntry.

CatalogQueryResponse

Object

The results of the search.

Name	Type	Description
continuationToken	string	The continuationToken for the next page.
value	CatalogEntry[]: ItemCatalogEntry[]	A list of catalog entries

CatalogWorkspace

Object

The workspace for the catalog entry.

Name	Type	Description
displayName	string	The display name of the workspace.
id	string (uuid)	The ID of the workspace.

ErrorRelatedResource

Object

The error related resource details object.

Name	Type	Description
resourceId	string	The resource ID that's involved in the error.
resourceType	string	The type of the resource that's involved in the error.

ErrorResponse

Object

The error response.

Name	Type	Description
errorCode	string	A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users.
isRetriable	boolean	When true, the request can be retried. Use the `Retry-After` response header to determine the delay, if available.
message	string	A human readable representation of the error.
moreDetails	ErrorResponseDetails[]	List of additional error details.
relatedResource	ErrorRelatedResource	The error related resource details.
requestId	string (uuid)	ID of the request associated with the error.

ErrorResponseDetails

Object

The error response details.

Name	Type	Description
errorCode	string	A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users.
message	string	A human readable representation of the error.
relatedResource	ErrorRelatedResource	The error related resource details.

ItemCatalogEntry

Object

A Fabric item type of catalog entry.

Name	Type	Description
catalogEntryType	string: FabricItem	The catalog entry type.
description	string	The description of the catalog entry.
displayName	string	The catalog entry display name.
hierarchy	ItemCatalogEntryHierarchy	The hierarchy of the catalog entry.
id	string (uuid)	The objectId of the catalog entry.
type	ItemType	The Fabric item type.

ItemCatalogEntryHierarchy

Object

The immediate ancestors of the item in Fabric's data architecture. Only applicable levels are returned.

Name	Type	Description
workspace	CatalogWorkspace	The workspace that contains the item.

ItemType

Enumeration

The type of the item. Additional item types may be added over time.

Value	Description
Dashboard	PowerBI dashboard.
Report	PowerBI report.
SemanticModel	PowerBI semantic model.
PaginatedReport	PowerBI paginated report.
Datamart	PowerBI datamart.
Lakehouse	A lakehouse.
Eventhouse	An eventhouse.
Environment	An environment.
KQLDatabase	A KQL database.
KQLQueryset	A KQL queryset.
KQLDashboard	A KQL dashboard.
DataPipeline	A data pipeline.
Notebook	A notebook.
SparkJobDefinition	A spark job definition.
MLExperiment	A machine learning experiment.
MLModel	A machine learning model.
Warehouse	A warehouse.
Eventstream	An eventstream.
SQLEndpoint	An SQL endpoint.
MirroredWarehouse	A mirrored warehouse.
MirroredDatabase	A mirrored database.
Reflex	A Reflex.
GraphQLApi	An API for GraphQL item.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	A Copy job.
VariableLibrary	A VariableLibrary.
Dataflow	A Dataflow.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	A Warehouse snapshot.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	A Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	A mirrored azure databricks catalog.
Map	A Map.
AnomalyDetector	An Anomaly Detector.
UserDataFunction	A User Data Function.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	A Snowflake Database to store Iceberg tables created from Snowflake account.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	A Cosmos DB Database.
Ontology	An Ontology.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.