---
title: "Get Actor Hierarchy for Current User"
method: GET
path: "/v1/actors/hierarchy"
tags: ["Actors"]
---

# Get Actor Hierarchy for Current User

`GET /v1/actors/hierarchy`

Retrieves the actor hierarchy for the current user. Optionally, you can specify an `ActorID` to get the hierarchy for a specific actor, filter by `StatusID`, or limit the hierarchy levels returned.

## Query parameters

- `ActorID` integer
- `StatusID` integer
- `HierarchyLevelLimit` integer

## Response `200`

The actor hierarchy was retrieved successfully.

- ActorHirarchyDto — Represents the hierarchy of an actor, including details about the actor and its children in the hierarchy.
  - `ParentActorID` integer, nullable — The unique identifier of the parent actor, if applicable. This indicates the actor's position within a larger hierarchy.
  - `ActorID` integer — The unique identifier of the actor.
  - `ActorDescription` string, nullable — A brief description of the actor.
  - `ActorTypeID` integer — The identifier representing the type of actor, defining their role or classification.
  - `ActorStatus` integer — The status identifier of the actor, indicating their current status.
  - `ActorHierarchyLevel` integer — The level of hierarchy at which the actor is positioned within the organizational structure.
  - `ActorChildren` ActorHirarchyDto[], nullable — A list of child actors that belong to this actor, representing the next level in the hierarchy.

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/revisions/421f6f83c257/schema)