Get all details for a keyterm

post

/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/keyterms/$views/KeytermDetails/$query

Request

Query Parameters
  • The effective date value in ISO 8601 date format 'YYYY-MM-DD'. This date is required by business logic to search for effective-dated business objects.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Match All
Show Source
Nested Schema : schema
Match All
Show Source
Nested Schema : schema
Type: object
Show Source
  • accessors
    Maps accessor names to query objects specific to corresponding accessors. Query object for each accessor supports query capabilities similar to the base.
  • fields
    Restricts the resource fields. Only the specified fields and mandatory system fields are returned.
  • subTypes
    Maps discriminator values (as defined in subtypes) to query objects specific to corresponding subtypes. Subtype-specific query objects support a subset(fields,accessors,filter) of the query capabilities when compared to the base.
Nested Schema : type
Type: object
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : accessors
Type: object
Maps accessor names to query objects specific to corresponding accessors. Query object for each accessor supports query capabilities similar to the base.
Nested Schema : fields
Type: array
Restricts the resource fields. Only the specified fields and mandatory system fields are returned.
Show Source
Nested Schema : subTypes
Type: object
Maps discriminator values (as defined in subtypes) to query objects specific to corresponding subtypes. Subtype-specific query objects support a subset(fields,accessors,filter) of the query capabilities when compared to the base.
Nested Schema : collection
Type: object
Defines query criteria that can be applied on a resource collection.
Show Source
  • The resource collection will be queried using the specified filter condition.
  • Restricts the number of resource items returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resource items.
  • Defines the starting position of the resource collection. If offset exceeds the resource count then no resource items are returned.
  • Represents the privilege or action required to check for while serving a request to access a resource.
  • sortBy
    Orders a resource collection based on the specified fields.
Nested Schema : sortBy
Type: array
Orders a resource collection based on the specified fields.
Show Source
Nested Schema : items
Match One Schema
Show Source
  • Name of field based on which sorting will happen. Order is ascending.
  • type
    Object with single entry. Key must be name of field based on which sorting will happen. Value must be either asc or desc to decide the sort order.
Nested Schema : type
Type: object
Object with single entry. Key must be name of field based on which sorting will happen. Value must be either asc or desc to decide the sort order.
Nested Schema : parameters
Type: object
Values to be applied in a parameterized filter specific to the view.
Back to Top

Response

Default Response

Successful response of retrieving view KeytermDetails for resource Key Terms
Body ()
Root Schema : keyterms_view-KeytermDetails
Match All
Show Source
Nested Schema : __collection_context
Type: object
Show Source
Nested Schema : keyterms_view-KeytermDetails-allOf[1]
Type: object
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : items
Match All
Show Source
Nested Schema : items-allOf[0]
Match All
Show Source
Nested Schema : __busObj_context
Type: object
Show Source
Nested Schema : items-allOf[0]-allOf[1]
Type: object
Show Source
Nested Schema : items-allOf[1]
Type: object
Nested Schema : $context
Type: object
Show Source
Nested Schema : group
Match All
Show Source
Nested Schema : outputType
Match All
Show Source
  • Title: Output Type
  • Allowed Values: [ "ORA_OKC_TEXT", "ORA_OKC_NUMBER", "ORA_OKC_DATE" ]
Nested Schema : prompts
Match All
Show Source
Nested Schema : group-allOf[1]
Type: object
Show Source
Nested Schema : description
Match All
Show Source
  • Read Only: true
  • Title: Lookup Code Description
    The translated description of the Lookup Code.
Nested Schema : lookupCode
Match All
Show Source
  • Read Only: true
  • Title: Lookup Code ID
    The unique identifier of the Lookup Code.
Nested Schema : lookupType
Match All
Show Source
  • Read Only: true
  • Title: Lookup Type ID
    The unique identifier of the Lookup Type.
Nested Schema : meaning
Match All
Show Source
  • Read Only: true
  • Title: Lookup Code Meaning
    The translated meaning of the Lookup Code.
Nested Schema : prompts-allOf[1]
Type: object
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : items
Match All
Show Source
Nested Schema : items-allOf[1]
Type: object
Show Source
Nested Schema : status
Match All
Show Source
  • Title: Status
    Default Value: ORA_OKC_DRAFT
  • Allowed Values: [ "ORA_OKC_DRAFT", "ORA_OKC_ACTIVE", "ORA_OKC_INACTIVE" ]
Back to Top

Examples

The following example shows how to get all details for a keyterm by submitting a post request on the REST resource using cURL.

cURL Command

curl -X POST --location 'https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/$en/keyterms/$views/KeytermDetails/$query' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' -D request.json

Example of Request Body

The following shows an example of the request body in JSON format.

{
    "collection":{
        "filter":"code = 'Limitation_Of_Liability'"
    }
}

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "items": [
        {
            "code": "Limitation_Of_Liability",
            "name": "Limitation Of Liability",
            "outputType": "ORA_OKC_TEXT",
            "activeFlag": true,
            "createdBy": "CONMGR",
            "timeCreated": "2025-01-13T19:43:15.508165Z",
            "updatedBy": "CONMGR",
            "timeUpdated": "2025-01-13T19:44:26.919026Z",
            "$id": "Limitation_Of_Liability",
            "$context": {
                "etag": "3",
                "links": {
                    "$self": {
                        "href": "https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/$en/keyterms/Limitation_Of_Liability"
                    }
                }
            },
            "group": {
                "lookupType": "ORA_OKC_KEY_TERM_GROUP",
                "lookupCode": "ATS_OKC_Operations",
                "meaning": "Operations",
                "description": null,
                "$id": "ORA_OKC_KEY_TERM_GROUP,ATS_OKC_Operations",
                "$context": {
                    "links": {
                        "$self": {
                            "href": "https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/$en/keytermGroups/ORA_OKC_KEY_TERM_GROUP%2CATS_OKC_Operations"
                        }
                    }
                }
            },
            "prompts": {
                "items": [
                    {
                        "id": "300100625947666",
                        "name": "Limitation Of Liability",
                        "description": null,
                        "text": "Is there a clause related to limitation of liability mentioned in the document?",
                        "status": "ORA_OKC_ACTIVE",
                        "createdBy": "CONMGR",
                        "$id": "300100625947666",
                        "$context": {
                            "etag": "4",
                            "links": {
                                "$self": {
                                    "href": "https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/$en/keyterms/Limitation_Of_Liability/prompts/300100625947666"
                                }
                            }
                        }
                    }
                ],
                "hasMore": false
            }
        }
    ],
    "hasMore": false
}
Back to Top