---
title: "Get only the relationship fields of a custom object"
method: GET
path: "/api/v1/custom-objects/by-id/{id}/relationships"
tags: ["customObjects"]
---

# Get only the relationship fields of a custom object

`GET /api/v1/custom-objects/by-id/{id}/relationships`

Returns the same `CustomObjectDetailsDto` shape as `getCustomObject`, but
`customData` is restricted to relationship reference keys only — scalar,
dropdown, date, and other non-relationship fields are omitted. Each
`objectType.sections[*].fieldIds` list is filtered to retain only the
field IDs that correspond to relationship field definitions; empty
sections are preserved so the UI gets a stable section layout.

Useful when a caller needs to display a CO's links to other entities
without paying the cost of resolving the full custom_data payload.

## Path parameters

- `id` integer, required

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Response `200`

Successful response

- CustomObjectsGetapiV1CustomObjectsByIdIdRelationshipsResponse200 — Empty response body

## Changes

- **2026-08-12** `2ab1cf36239b` — 1 info
  - api operation id `getapi-v-1-custom-objects-by-id-id-relationships` removed and replaced with `getapi_v1_custom_objects_by_id__id__relationships`

[Change history](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/changes/api/v1/custom-objects/by-id/:id/relationships/get.md)

---

[API](https://skmtc.dev/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/revisions/6223f7496274/schema)