---
title: Get Related Business Objects
slug: neurons-for-itsm/admin-user-help/enu/latest/get-related-business-objects
createdAt: 2026-07-14T19:16:52.654Z
---

You can get all the related business objects that are linked to a business object.

**Base URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}('\{business object unique key}')/\{relationship name}

:::hint{type="info"}
Ensure the business object name is suffixed with an "s".
:::

:::ExpandableHeading
## Get Related Business Objects - Example

Here is an example to get related business objects linked to an incident.

| URL                                 | `https://{tenant url}/api/odata/businessobject/incidents`<br />`('0A8C17C5DF534513AACCBB543C60B1D5')/IncidentContainsJournal`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#0C121D">Method</font> | GET                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Header Name                         | Authorization: JTW Token/Session Key/REST API Key                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Status Code                         | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Response Payload                    | `{`<br />`"@odata.context": "{tenant url}/api/odata/$metadata`<br />`#Collection(MetaData.journal)",`<br />`"value": [`<br />`{`<br />`"Category_Valid": "079449CD8C0040E7B580AD0DFFAC76FB",`<br />`"Category": "Outgoing Email",`<br />`"CreatedBy": "ATaylor",`<br />`"CreatedDateTime": "2019-02-01T04:55:28Z",`<br />`"JournalType": "Email",`<br />`"LastModBy": "ATaylor",`<br />`"LastModDateTime": "2019-02-01T04:55:28Z",`<br />`"Owner_Valid": null,`<br />`"Owner": null,`<br />`"OwnerTeam_Valid": null,`<br />`"OwnerTeam": null,`<br />`"OwnerType": "",`<br />`"ParentLink_Category": "Incident",`<br />`"ParentLink_RecID": "0A8C17C5DF534513AACCBB543C60B1D5",`<br />`"ParentLink": null,`<br />`"RecId": "06E745A9F96F412CB92DB567911D8F4F",`<br />`"Subject": "Incident# 21206 is assigned to your group",`<br />`"TypeAlias": null,`<br />`"PublishToWeb": false,`<br />`"AttachmentName": null,`<br />`"AttachmentExtension": null,`<br />`"AttachmentData": "",`<br />`"ReadOnly": false,`<br />`"IsNewRecord": false,`<br />`"IsUnRead": false,`<br />`"ParentOwner": "RThomas",`<br />`"UnreadTransition": false`<br />`}`<br />`]`<br />`}` |
:::

## Unsuccessful Responses

:::ExpandableHeading
## Invalid URL

Scenario: Trying to get related business objects when the url is invalid.

Invalid URL examples:

https\://\{tenant url}/api/odata/businessobject/incident('0A8C17C5DF534513AACCBB543C60B1D5')/IncidentContainsJournal

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4004                                                                                                   |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Description                                   | Bad Request                                                                                                 |
| Message                                       | `[  `<br />`"No service for type 'Microsoft.OData.Edm.IEdmModel'  `<br />`has been registered."  `<br />`]` |
| <font color="#0C121D">HTTP STATUS CODE</font> | 404                                                                                                         |
:::

:::ExpandableHeading
## Invalid RecID

Scenario: Trying to get related business objects when the RecID of the linked main business object is invalid.

Example:

https\://\{tenant url}/api/odata/businessobject/incidents('1234')/IncidentContainsJournal

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4000                                                 |
| --------------------------------------------- | --------------------------------------------------------- |
| Description                                   | Invalid Request                                           |
| Message                                       | `[  `<br />`"Linked resource does not exist."  `<br />`]` |
| <font color="#0C121D">HTTP STATUS CODE</font> | 400                                                       |
:::