Get a Business Concept (v3)
Returns one Business Concept by UUID or fully qualified code.
REST Resource
GET
/HyperionPlanning/rest/v3/applications/{application}/businessconcepts/{conceptIdOrCode}
Required Roles
Service Administrator
Requests
Supported Media Types: application/json
The following table summarizes the client request parameters:
Table 3-74 Get a Business Concept — Request Parameters
| Name | Description | Type | Required |
|---|---|---|---|
application |
Application name. Specified in the resource path. | string | Yes |
conceptIdOrCode |
Business Concept UUID or fully qualified code. Specified in the resource path. | string | Yes |
Response
Success schema: BusinessConcept
The following table lists the response parameters:
Table 3-75 Get a Business Concept - Response Parameters
| Name | Description | Type |
|---|---|---|
id |
Stable external Business Concept UUID. | string (UUID) |
code |
Stable fully qualified Business Concept code. | string |
displayName |
Display name for the Business Concept. Accepts null. | string |
description |
Business-facing description of the concept. Accepts null. | string |
synonyms |
Comma-separated synonyms used by search and resolve. Accepts null. | string |
examplePhrases |
Example user phrases used by AI resolution. Accepts null. | string |
textLocale |
Locale hint for textual metadata. Accepts null. | string |
searchKeywords |
Additional curated keywords used by search and resolve. Accepts null. | string |
searchPriority |
Relative priority used to boost or break ties among matches. | integer |
source |
Source of the Business Concept. Allowed values:
CUSTOMER, ORACLE,
PARTNER, AI_PROPOSED.
|
string |
string |
Lifecycle status of the Business Concept. Allowed values:
DRAFT, APPROVED,
PUBLISHED, DEPRECATED.
|
string |
parentId |
Parent Business Concept UUID, if any. Accepts null. | string (UUID) |
parentCode |
Parent Business Concept code, if any. Accepts null. | string |
Sample Response:
{
"id": "33333333-3333-4333-8333-333333333333",
"code": "CUSTOM.RECURRING_REVENUE",
"displayName": "Recurring Revenue",
"description": "Revenue expected to repeat across periods.",
"synonyms": "subscription revenue, renewal revenue",
"examplePhrases": "How can I grow ARR?",
"textLocale": "en",
"searchKeywords": "renewal expansion motion",
"searchPriority": 30,
"source": "CUSTOMER",
"status": "APPROVED",
"parentId": "11111111-1111-4111-8111-111111111111",
"parentCode": "ORACLE.FINANCIALS.REVENUE"
}