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"
}