When a customer belongs to an account hierarchy, the hierarchy
resource represents the customer's position within that hierarchy. The hierarchy provides details about the customer's parent, children, invoice owner, and payment owner.
Note - A customer can have a maximum of 250 direct children.
- The hierarchy allows a maximum of 5 levels from the root node to the lowest child node.
Sample hierarchy [ JSON ]
{
"object": "hierarchy",
"customer_id": "test_AwBq83Tr3XLU0AfLB",
"parent_id": "test_AwBq83Tr3XL9WAfIB",
"children_ids": [
"test_AwBq83Tr3XLprAfNq",
"test_Azz5ePTp3DWPk4Qh"
],
"payment_owner_id": "test_AwBq83Tr3XL9WAfIB",
"invoice_owner_id": "test_AwBq83Tr3XL9WAfIB"
}
API Index URL GET
https://{site}.chargebee.com/api/v2/hierarchies
string, max chars=50 The id
of the customer associated with this hierarchy
resource.
optional, string, max chars=50 The id
of the immediate parent for the customer identified by customer_id
. If the customer is the root of the hierarchy, this attribute isn't returned.
string, max chars=50 The id
of the customer responsible for paying the invoices for the customer identified by customer_id
. This ID must match either customer_id
or invoice_owner_id
.
string, max chars=50 The id
of the customer who receives the invoice for charges incurred by the customer identified by customer_id
. This ID must match either customer_id
or one of its ancestors.
optional, boolean Indicates whether the customer has child accounts in the hierarchy.
optional, list of string A list of id
s representing the immediate children, if any exist, for the customer identified by customer_id
.
string, max chars=50 The id
of the customer associated with this hierarchy
resource.
optional, string, max chars=50 The id
of the immediate parent for the customer identified by customer_id
. If the customer is the root of the hierarchy, this attribute isn't returned.
string, max chars=50 The id
of the customer responsible for paying the invoices for the customer identified by customer_id
. This ID must match either customer_id
or invoice_owner_id
.
string, max chars=50 The id
of the customer who receives the invoice for charges incurred by the customer identified by customer_id
. This ID must match either customer_id
or one of its ancestors.
optional, boolean Indicates whether the customer has child accounts in the hierarchy.
optional, list of string A list of id
s representing the immediate children, if any exist, for the customer identified by customer_id
.