---
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`

## Request

- Base URL: `https://example.com:443`
- URL: `https://example.com:443/v1/actors/hierarchy`
- Auth: none required
- TypeScript: <https://skmtc.dev/nayax/apis/nayax-cortina-api/docs/v1/actors/hierarchy/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/nayax/apis/nayax-cortina-api.md) - [All operations](https://skmtc.dev/nayax/apis/nayax-cortina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nayax/apis/nayax-cortina-api/revisions/421f6f83c257?raw)