---
title: "Get all asset relationships"
method: GET
path: "/v2/itam/asset-relationship/relations"
tags: ["Asset Relationships"]
---

# Get all asset relationships

`GET /v2/itam/asset-relationship/relations`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/itam/asset-relationship/relations`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/itam/asset-relationship/relations/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of all asset relationships, optionally filtered by relationship type.

## Query parameters

- `type` string: The relation type used to filter relationships. By default all relation types are returned.
- `after` string: Cursor for forward pagination. Use nextCursor from previous response.
- `before` string: Cursor for backward pagination. Use previousCursor from previous response.
- `pageSize` integer: Number of results per page. Defaults to 100, minimum 1, maximum 500.

## Response `200`

A paginated list of asset relationships

- object: Paginated response containing asset relationships
  - `results` object[]: List of asset relationships
    - `relationId` integer: Unique identifier of the relationship
    - `source` object: Target asset in the relationship
      - `id` integer: Unique identifier of the asset
      - `entityType` 'DEVICE' | 'CHECKLIST' | 'CONTACT' | 'CREDENTIAL' | 'APPS_SERVICES_DOCUMENT' | 'TECHNICIAN' | 'END_USER' | 'KB_ARTICLE' | 'LOCATION' | 'ORGANIZATION': Type of the entity
      - `name` string: Name of the asset
      - `clientId` integer: Client identifier, if applicable
    - `target` object: Target asset in the relationship
      - `id` integer: Unique identifier of the asset
      - `entityType` 'DEVICE' | 'CHECKLIST' | 'CONTACT' | 'CREDENTIAL' | 'APPS_SERVICES_DOCUMENT' | 'TECHNICIAN' | 'END_USER' | 'KB_ARTICLE' | 'LOCATION' | 'ORGANIZATION': Type of the entity
      - `name` string: Name of the asset
      - `clientId` integer: Client identifier, if applicable
    - `relation` object: Type of the relationship
      - `id` integer: Unique identifier of the relation type
      - `forwardLabel` string: Label for the forward direction
      - `reverseLabel` string: Label for the reverse direction
      - `systemDefault` boolean: Whether this is a system default relation
  - `pageInfo` object: Pagination information for paginated responses
    - `count` integer: Total count of results in this page
    - `nextCursor` string: Cursor for the next page. Use with 'after' parameter.
    - `previousCursor` string: Cursor for the previous page. Use with 'before' parameter.
    - `hasMore` boolean: Indicates if there are more results after this page
    - `hasPrevious` boolean: Indicates if there are results before this page

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Missing required permissions

## Changes

- **2026-07-12** `dec5d4ed264e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/itam/asset-relationship/relations/get.md)

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)