Comments are additional information that you can add to your resources. Comments can be added to provide context for any operation that was performed.
When you make an API call on any resource, for example, Subscriptions -> Change term end, you can add more context to that operation by calling the comments API as a follow up call.
Besides the user generated comments, Chargebee also generates "System" comments when a change for a resource happens at the backend. These comments are all read-only.
Sample comment [ JSON ]
{
"added_by": "full_access_key_v1",
"created_at": 1548178762,
"entity_id": "__test__5SK0bLNFRFuCJKINu",
"entity_type": "subscription",
"id": "cmt___test__5SK0bLNFRFuCJMIO1",
"notes": "This is a test comment",
"object": "comment",
"type": "user"
}
API Index URL GET
https://{site}.chargebee.com/api/v1/comments
Model Class
Comment attributes
id
string, max chars=40 Unique identifier for the comment.
enumerated string Type of the entity this comment generated for
Possible values are
customerEntity that represents a customersubscriptionEntity that represents a subscription of a customertransactionEntity that represents a transaction.planEntity that represents a subscription plan
{
"comment": {
"added_by": "full_access_key_v1",
"created_at": 1548178762,
"entity_id": "__test__5SK0bLNFRFuCJKINu",
"entity_type": "subscription",
"id": "cmt___test__5SK0bLNFRFuCJMIO1",
"notes": "This is a test comment",
"object": "comment",
"type": "user"
}
}
URL Format
POST
https://{site}.chargebee.com/api/v1/comments
Method
Input Parameters
entity_type[]
required, enumerated string Type of the entity to create the comment for.
Possible values are
customerEntity that represents a customersubscriptionEntity that represents a subscription of a customertransactionEntity that represents a transaction.planEntity that represents a subscription plan
Retrieve the list of comments sorted by the recent ones on the top.
If you want to retrieve the list of comments for an entity, for example, subscription you can filter them by passing the entity type and unique identifier for that entity, for example, subscription ID.
This API is not enabled for live sites by default. Please contact
support to get this enabled.
optional, string, max chars=1000 Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set offset to the value of next_offset obtained in the previous iteration of the API call.
optional, enumerated string Type of the entity this comment generated for.
Possible values are
customerEntity that represents a customersubscriptionEntity that represents a subscription of a customertransactionEntity that represents a transaction.planEntity that represents a subscription plan
always returned optional, string, max chars=1000 This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter `offset`.