---
title: "GET /lineage/{guid}/next"
method: GET
path: "/lineage/{guid}/next"
---

# GET /lineage/{guid}/next

`GET /lineage/{guid}/next`

Return immediate next page lineage info about entity with pagination

## Path parameters

- `guid` string, required

## Query parameters

- `api-version` string, required
- `direction` 'INPUT' | 'OUTPUT' | 'BOTH', required
- `offset` integer
- `limit` integer

## Response `200`

The request has succeeded.

- AtlasLineageInfo — The lineage information.
  - `baseEntityGuid` string — The GUID of the base entity.
  - `guidEntityMap` object — The GUID entity map.
  - `widthCounts` object — The entity count in specific direction.
  - `lineageDepth` integer — The depth of lineage.
  - `lineageWidth` integer — The width of lineage.
  - `childrenCount` integer — The number of children node.
  - `lineageDirection` 'INPUT' | 'OUTPUT' | 'BOTH' — Lineage direction
  - `parentRelations` ParentRelation[] — An array of parentRelations relations.
    - `childEntityId` string — The GUID of child entity.
    - `relationshipId` string — The GUID of relationship.
    - `parentEntityId` string — The GUID of parent entity.
  - `relations` LineageRelation[] — An array of lineage relations.
    - `fromEntityId` string — The GUID of from-entity.
    - `relationshipId` string — The GUID of relationship.
    - `toEntityId` string — The GUID of to-entity.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-09-01) `442226cb14a9` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2026-07-13** (2023-09-01) `5afce6b3aae1` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/purview-datamap/changes/lineage/:guid/next/get.md)

---

[API](https://skmtc.dev/azure/apis/purview-datamap.md) · [All operations](https://skmtc.dev/azure/apis/purview-datamap/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-datamap/revisions/442226cb14a9/schema)