---
title: "POST /browse"
method: POST
path: "/browse"
tags: ["Discovery"]
---

# POST /browse

`POST /browse`

Browse entities by path or entity type.

## Query parameters

- `api-version` string, required

## Request body

- BrowseRequest — The criteria of browse request.
  - `entityType` string — The entity type to browse as the root level entry point.
  - `path` string — The path to browse the next level child entities.
  - `limit` integer — The number of browse items we hope to return. The maximum value is 10000.
  - `offset` integer — The offset. The default value is 0. The maximum value is 100000.

## Response `200`

OK. On successful get the entities to browse.

- BrowseResult — The result item of the browse request.
  - `@search.count` integer — The total number of browse results.
  - `value` BrowseResultValue[]
    - `entityType` string — The type name of the record.
    - `id` string — The GUID of the record.
    - `isLeaf` boolean — If the record is a leaf entity.
    - `name` string — The name of the record.
    - `owner` BrowseResultOwner[] — The owners of the record.
      - `id` string — The GUID of the owner.
      - `displayName` string — The display name of the owner.
      - `mail` string — The mail of the owner.
      - `contactType` string — The contact type of the owner. The value will be Owner.
    - `path` string — The path of the record.
    - `qualifiedName` string — The qualified name of the record.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/purview-catalog.md) · [All operations](https://skmtc.net/azure/apis/purview-catalog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purview-catalog/revisions/63dd676f9a6b/schema)