The Credit Balance Transaction object

Attributes

id string Unique identifier for the object.
object string, value is "billing.credit_balance_transaction" String representing the object’s type. Objects of the same type share the same value.
created timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
credit nullable object Credit details for this credit balance transaction. Only present if type is credit.
credit _ grant string Expandable The credit grant associated with this credit balance transaction.
debit nullable object Debit details for this credit balance transaction. Only present if type is debit.
effective _ at timestamp The effective time of this credit balance transaction.
livemode boolean If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.
test _ clock nullable string Expandable ID of the test clock this credit balance transaction belongs to.
type nullable enum The type of credit balance transaction (credit or debit). Possible enum values credit A credit transaction. debit A debit transaction.

{ "id": "cbtxn_test_61R9ZljjaFmdidb6e41L6nFOS1ekD9Ue", "object": "billing.credit_balance_transaction", "created": 1726619524, "credit": null, "credit_grant": "credgr_test_61R9ZkIkIzLSp0xze41L6nFOS1ekDTPE", "debit": { "amount": { "monetary": { "currency": "usd", "value": 1000 }, "type": "monetary" }, "credits_applied": { "invoice": "in_1Q0BoLL6nFOS1ekDbwBM5ER1", "invoice_line_item": "il_1QB443L6nFOS1ekDwRiN3Z4n" }, "type": "credits_applied" }, "effective_at": 1729211351, "livemode": false, "test_clock": "clock_1Q0BoJL6nFOS1ekDbyYYuseM", "type": "debit"}

Retrieve a credit balance transaction

GET / v1 / billing / credit_balance_transactions /:id

Retrieves a credit balance transaction.

Parameters

id string Required Unique identifier for the object.

Returns

Returns a credit balance transaction.

Response

{ "id": "cbtxn_test_61R9ZljjaFmdidb6e41L6nFOS1ekD9Ue", "object": "billing.credit_balance_transaction", "created": 1726619524, "credit": null, "credit_grant": "credgr_test_61R9ZkIkIzLSp0xze41L6nFOS1ekDTPE", "debit": { "amount": { "monetary": { "currency": "usd", "value": 1000 }, "type": "monetary" }, "credits_applied": { "invoice": "in_1Q0BoLL6nFOS1ekDbwBM5ER1", "invoice_line_item": "il_1QB443L6nFOS1ekDwRiN3Z4n" }, "type": "credits_applied" }, "effective_at": 1729211351, "livemode": false, "test_clock": "clock_1Q0BoJL6nFOS1ekDbyYYuseM", "type": "debit"}

List credit balance transactions

GET / v1 / billing / credit_balance_transactions

Retrieve a list of credit balance transactions.

Parameters

credit _ grant string The credit grant for which to fetch credit balance transactions.
customer string The customer whose credit balance transactions you’re retrieving.
customer _ account string The account representing the customer whose credit balance transactions you’re retrieving.

More parameters

ending _ before string
limit integer
starting _ after string

Returns

Returns a list of credit balance transactions.

Response