Get a tier class

get

/crmRestApi/resources/11.13.18.05/loyPrograms/{LoyProgramId}/child/TierClasses/{TierClassesUniqID}

Request

Path Parameters
  • The primary key to identify a program. Oracle Loyalty Cloud generates this attribute value during the creation of a program record. There is no default value, dependency, or limitation associated with this attribute.
  • This is the hash key of the attributes which make up the composite key for the Tier Classes resource and used to uniquely identify an instance of Tier Classes. The client should not generate the hash key value. Instead, the client should query on the Tier Classes collection resource in order to navigate to a specific instance of Tier Classes to get the hash key.
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : loyPrograms-TierClasses-item-response
Type: object
Show Source
  • Title: Active
    Maximum Length: 1
    Default Value: false
    The boolean attribute that identifies whether the tier class is currently active or not. The default value is N. There is no dependency or limitation associated with this attribute.
  • Title: Tier Class Applied
    Maximum Length: 1
    Default Value: false
    The boolean attribute that specifies whether the tier class is applied to existing members. The default value is N. There is no dependency or limitation associated with this attribute.
  • Title: Approver ID
    The user that approves tier downgrades. There is no dependency or limitation associated with this attribute.
  • Title: Assessment Day
    Maximum Length: 30
    Default Value: 1
    The tier assess date code specifies the day to schedule a tier assessment for a tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Assessment Month
    Maximum Length: 30
    Default Value: 1
    The tier assess month identifier specifies the month to schedule a tier assessment for a tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Recurring Period Meaning
    Read Only: true
    Maximum Length: 80
    The tier assess recurring attribute specifies how frequently the tier assessment schedule is repeated. Assessment recurrence period options are Monthly and Yearly. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Recurring Period
    Maximum Length: 30
    Default Value: ORA_TR_LEN_UOM_YEAR
    The tier assess recurring code specifies how frequently the tier assessment schedule is repeated. Assessment recurrence period options are Monthly and Yearly. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Card Type Meaning
    Read Only: true
    Maximum Length: 80
    The attribute indicates the member card type associated with a tier under a tier class. There is no default value, dependency, nor limitation associated with this attribute.
  • Title: Card Type Code
    Read Only: true
    Maximum Length: 30
    The attribute indicates the member card type associated with a tier under a tier class. There is no default value, dependency, nor limitation associated with this attribute.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user that created the tier class. Oracle Loyalty Cloud generates this attribute value during the creation of a new tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Creation Date
    Read Only: true
    The date when the tier class is created. Oracle Loyalty Cloud generates this attribute value during the creation of a new tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: End Tier Length Unit of Measure
    Maximum Length: 30
    The tier end date is calculated using the value of the Minimum Tier Length and Minimum Tier Length Period parameters. The minimum period specifies the time that a member is guaranteed membership in any tier within the tier class. For example, if the minimum period is six months, then length is 6, and Period UOM is Month. There is no default value or limitation associated with this attribute.
  • Title: End Tier Period Month
    Maximum Length: 30
    The end tier month day code attribute specifies the day of the month when the tier period month ends. There is no default value, dependency, or limitation associated with this attribute.
  • Title: End Tier Period Day
    Maximum Length: 30
    The end tier period day code attribute specifies the day when the tier period ends. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Last Update Date
    Read Only: true
    The date when the tier class record is last updated. Oracle Loyalty Cloud generates this attribute value and updates it whenever changes to the tier class occur. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user that last updated the tier class. Oracle Loyalty Cloud generates this attribute value and updates it whenever changes to the tier class occur. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login details of the user that last updated the tier class. Oracle Loyalty Cloud generates this attribute value and updates it whenever changes to the tier class occur. There is no default value, dependency, or limitation associated with this attribute.
  • Links
  • Title: Loyalty Tier Class ID
    The primary key of the loyalty tier class. Oracle Loyalty Cloud generates this attribute value. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Minimum Tier Length in Months
    The minimum period of time that a member is guaranteed membership in any tier within this tier class. For example, if the minimum period is six months, then length is 6 and Period is Month. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Primary Tier
    Maximum Length: 30
    The attribute indicates the name of primary tier of a tier class. A tier class can have only one primary tier class. There is no default value, dependency, nor limitation associated with this attribute.
  • Title: Primary Tier ID
    The primary tier identifier is the lowest tier of the tier class and is the tier where members are first enrolled. This value can only be specified after the tiers have been created for this class, and it must be specified before activating the tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Qualifying Points
    Read Only: true
    The attribute indicates the minimum number of points required to qualify a tier. There is no dependency or limitation associated with this attribute.
  • Title: Qualifying Period Length in Months
    The qualifying period length specifies the length for the initial qualifying period for the tier. For example, if the qualifying period is one year, the period length is 1. It is recommended that the Quality Period Length be defined at the Tier Class level. However, if the Quality Period Length is defined at Tier level, then the tier level definition takes precedence. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Qualifying Period Unit of Measure
    Maximum Length: 30
    The qualifying period unit of measure (UOM) code specifies the UOM for the initial qualifying period for the tier. For example, if the qualifying period is one year, then UOM is Year. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Qualifying Point Type
    The unique identifier of the qualifying point type of a tier class. There is no dependency or limitation associated with this attribute.
  • Title: Requalifying Period Unit of Measure
    Maximum Length: 30
    The requalifying period unit of measure (UOM) code specifies the UOM for the qualifying period for existing members to remain in this tier. Usually, this period is the same as the initial qualifying period. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Requalifying Period Length
    The requalifying period length identifier specifies the length for the qualifying period for existing members to remain in the same tier. Usually, the period is same as the initial qualifying period. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Restart Qualifying Period
    Maximum Length: 30
    The restart qualifying period specifies the length of time for the new qualifying period that starts after a tier status change. Possible options are Qualifying Period Expiration (the length of time after the new qualifying period starts at the expiration of the current qualifying period) or Tier Status Change (the length of time for the new qualifying period to start, immediately when the tier changes). There is no default value, dependency, or limitation associated with this attribute.
  • Title: Sequence Number
    Read Only: true
    The unique sequence number of the corresponding tier of a tier class. There is no dependency or limitation associated with this attribute.
  • Title: Tier End Date Snapped to Meaning
    Read Only: true
    Maximum Length: 80
    The attribute indicates the date of the tier end that should map with for the member's tier record. Possible values in this are 1st day of Month, 1st day of Quarter, 1st day of year, or a calculated date.
  • Title: Tier End Date Snapped To
    Maximum Length: 30
    Default Value: ORA_EXP_ADJ_CALC_DATE
    This attribute indicates the date of the tier end that should map with for the member's tier record. Possible values in this are 1st day of Month, 1st day of Quarter, 1st day of year or calculated date.
  • Title: Tier Assessment Model Meaning
    Read Only: true
    Maximum Length: 80
    The restart qualifying period specifies the length of time for the new qualifying period that starts after a tier status change. Possible options are Qualifying Period Expiration (the length of time after the new qualifying period starts at the expiration of the current qualifying period) or Tier Status Change (the length of time for the new qualifying period to start, immediately when the tier changes). There is no default value, dependency, or limitation associated with this attribute.
  • Title: Tier Assessment Model
    Maximum Length: 30
    Default Value: ORA_TR_MODEL_NONE
    The start qualifying period code specifies when the qualifying period starts. The option determines the tier assessment model. The possible options are Enrollment Date/Anniversary Date, First Day of Month, Fixed Date, and Rolling. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Start Qualifying Period Day
    This attribute indicates tier qualifying period start day. There is no dependency or limitation associated with this attribute.
  • Title: Start Qualifying Period Day
    Maximum Length: 30
    The start qualifying period day code specifies the day from when the qualifying period starts. The option determines the tier assessment model. The possible options are Enrollment Date/Anniversary Date, First Day of Month, Fixed Date, and Rolling. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Start Qualifying Period Month
    Maximum Length: 30
    The start qualifying period month code specifies the month from when the qualifying period starts. The option determines the tier assessment model. The possible options are: Enrollment Date/Anniversary Date, First Day of Month, Fixed Date, Rolling. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Start Tier Period Day
    This attribute indicates tier period start day. There is no dependency or limitation associated with this attribute.
  • Title: Start Tier Period Day
    Maximum Length: 30
    The start tier period day specifies the day from when the tier period starts. The possible options of Start Tier Period are Enrollment/Anniversary Date or Fixed date. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Start Tier Period Month
    Maximum Length: 30
    The start tier period month specifies the month from when the tier period month starts. Possible options of Start Tier Period are Enrollment/Anniversary Date or Fixed date. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Tier Class Name
    Maximum Length: 30
    The attribute is a unique identifier that indicates the name of the tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Loyalty Tier ID
    Read Only: true
    The primary key of loyalty tiers corresponding to a tier class. There is no dependency or limitation associated with this attribute.
  • Title: Tier Name
    Read Only: true
    Maximum Length: 30
    The name of tier defined under the tier class. There is no default value, dependency, or limitation associated with this attribute.
  • Title: Tier Period Length in Months
    This attribute indicates tier period length. There is no dependency or limitation associated with this attribute.
  • Title: Type Code
    Maximum Length: 30
    The type code attribute previously specified the tier class type in a multiple tier class scenario. Oracle Loyalty Cloud does not currently use this attribute. There is no default value, dependency, nor limitation associated with this attribute.
Back to Top