---
title: Get Business Objects by Search
slug: neurons-for-itsm/admin-user-help/enu/latest/get-business-objects-by-search
createdAt: 2026-07-14T19:16:35.229Z
---

Fetches business object records based on the defined search keyword. For example, you can define to fetch incidents that contains boardroom in it.

**Base URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$search=\{search keyword}

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

:::ExpandableHeading
## Get Business Object by Search - Example

Here is an example to fetch incidents that contains boardroom.

| URL                                           | `https://{tenant url}/api/odata/businessobject/incidents?$search=Boardroom`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#0C121D">Method</font>           | GET                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Header Name                                   | Authorization: JTW Token/Session Key/REST API Key                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <font color="#0C121D">Status Code</font>      | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <font color="#0C121D">Response Payload</font> | \{&#xD;"@odata.context": "\{tenant url}/api/odata/$metadata#incidents",&#xD;"@odata.count": 2,&#xD;"value": \[&#xD;\{&#xD;"ActualCategory\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",&#xD;"ActualCategory": "Missing Item",&#xD;"Category\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",&#xD;"Category": "Missing Item",&#xD;"CauseCode\_Valid": "E2489F3F7DA34B898CCD9569CA5541F2",&#xD;"CauseCode": "Other",&#xD;"ClosedBy": "JClerk",&#xD;"CreatedBy": "JClerk",&#xD;"Email": "KDavidson\@saasitdemo.com",&#xD;"RecId": "003B58C0B4554E4BAA30DFD88876582A",&#xD;"Subject": "Remote control for projector in Boardroom is are missing ",&#xD;"Symptom": "This is an issue as it is roof mounted and cannot be switched on/off without the remote",&#xD;"Urgency\_Valid": "44021B6CC6E44E598868C4B3306053AE",&#xD;"Urgency": "Medium",&#xD;"LoginId": "KDavidson",&#xD;},&#xD;\{&#xD;"ActualCategory\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",&#xD;"ActualCategory": "Missing Item",&#xD;"Category\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",&#xD;"Category": "Missing Item",&#xD;"CauseCode\_Valid": "",&#xD;"CauseCode": "",&#xD;"ClosedBy": null,&#xD;"CreatedBy": "SDavis",&#xD;"RecId": "FAC9B02CB80041768D99EACE6A5DAD43",&#xD;"Subject": "Remote control for projector in Boardroom is are missing ",&#xD;"Symptom": "This is an issue as it is roof mounted and cannot be switched on/off without the remote",&#xD;"Urgency\_Valid": "44021B6CC6E44E598868C4B3306053AE",&#xD;"Urgency": "Medium",&#xD;"LoginId": "KDavidson",&#xD;}, |
:::

## Unsuccessful Response

:::ExpandableHeading
## No Records

Scenario: Trying to fetch incidents with search keyword that does not have any records.

https\://\{tenant url}/api/odata/businessobject/incidents?$search=xxx

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4000               |
| --------------------------------------------- | ----------------------- |
| Description                                   | Bad Request             |
| Message                                       | "No such entry exists". |
| <font color="#0C121D">HTTP STATUS CODE</font> | **400**                 |
:::