Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!


Home > Aria Crescendo core api > get_catalog_hierarchy_m


This API Gets the hierarchy of plans for a given client. It Provides the ability to filter the results to return the catalog hierarchy by promo code, parent plan number, client parent plan ID. Each filter can be used independently or in combination to provide control on reading the catalog. The intent of this API is to give a developer more control on reading the plan hierarchy.

For information on error messages generated by this API, see get_catalog_hierarchy_m Error Messages.

Input Arguments

Req Field Name Field Type Max Length Description
client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
  promo_code string 30 Filter the results based on an Aria promo code. Return all master plans for a specified promo_code (promo_code). If no promo code is specified it will return all master plans.
  include_plan_hierarchy string 5 If the include_plan_hierarchy parameter is set to true, then all of the child plans down to the bottom level of the plan hierarchy will be returned. If no value specified return the entire hierarchy.   Allowable Values
  parent_plan_no long 22 Aria-assigned unique plan identifier for the parent plan. If provided this returns all the plans one level below the parent_plan_no.
  client_parent_plan_id string 100 Client-defined Plan ID to query for available child plans
  locale_no long 22 Aria-assigned unique identifier of the locale used for translations. This value must be unique across all Aria clients.
  locale_name string 50 Name of the locale.
  include_parent_plan_list string 5 Indicates whether to include the list of parent plans in the all_plans_basic_details array.If no value specified,the list of parent plans is returned.   Allowable Values
  include_child_plans_list string 5 Indicates whether to include the list of child plans in the all_plans_basic_details array.If no value is specified, the list of child plans is returned.   Allowable Values
  include_total_count string 5 Indicates whether to include the total count of plans.If set to true it will return the total count of plan   Allowable Values
  limit long 3 Limits the number of records returned in the all_plan_basic_details array. Min of 1 and Max 999. If no value specified, the default is 100.
  offset long 3 The number of records to skip in the all_plan_basic_details array. Min of 0 and Max 998. If no value specified the default is 0.

Output Arguments

Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.
plans_count long Returns a total count of the number of Plans in the Client.
all_plan_basic_details hash Multidimensional array of returned plans and plan structure.
plan_no long Aria-assigned unique plan identifier
plan_name string Plan Name
supp_plan_ind long Indicates whether or not this plan is a supplemental plan.   Allowable Values
client_plan_id string Client assigned unique plan identifier
parent_plan_list hash Array of plans which are mapped as parents of this plan
parent_plan_no long ID of the parent plan
parent_plan_name string Name of the parent plan
client_parent_plan_id string Client-defined unique parent Plan ID
child_plan_list hash Array of the plans mapped as children of this plan
plan_no long Aria generated unique ID of the plan
client_plan_id string Client-defined unique ID for the plan
Last modified


This page has no custom tags.


This page has no classifications.