---
title: "Retrieve a single item-relation by its ID"
method: GET
path: "/api/workspaces/item-relations/{itemRelationId}"
tags: ["CRUD", "Items:Relations"]
---

# Retrieve a single item-relation by its ID

`GET /api/workspaces/item-relations/{itemRelationId}`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/workspaces/item-relations/{itemRelationId}`
- Auth: HTTP bearer

Returns found item-relation.<br/>Requirements:<br/>- auth-client scopes: "workspace:read"<br/>- user permission: "read" or higher

## Path parameters

- `itemRelationId` string, uuid, required

## Query parameters

- `actAsAdmin` boolean

## Response `200`

- ItemRelationWithItemRelationEmbed
  - `_embedded` ItemRelationEmbed, required
    - `constraints` ItemRelationConstraint[], required
      - `extensionId` string, uuid, required
      - `type` 'readonly', required
  - `childId` string, uuid, required
  - `childOrder` integer, required
  - `id` string, uuid, required
  - `parentId` string, uuid, required
  - `parentOrder` integer, required

## Other responses

- `400`: If path parameters are invalid or payload is invalid or resource does not exist.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, or authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

[API](https://skmtc.dev/airfocus/apis/airfocus-api.md) · [All operations](https://skmtc.dev/airfocus/apis/airfocus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/airfocus/apis/airfocus-api/revisions/fc9ccaa2ec6d?raw)