# Retrieve the credit balance summary for a customer

Retrieves the credit balance summary for a customer.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. createCustomer
POST /v1/customers {"name":"Jenny Rosen","email":"jennyrosen@example.com"}

## Request

```curl
curl -G https://api.stripe.com/v1/billing/credit_balance_summary \
  -u "<<YOUR_SECRET_KEY>>" \
  -d customer={{CUSTOMER_ID}} \
  -d "filter[type]=credit_grant" \
  -d "filter[credit_grant]=credgr_test_61R9rvFh1HgrFIoCp41L6nFOS1ekDCeW"
```

### Response

```json
{
  "object": "billing.credit_balance_summary",
  "balances": [
    {
      "available_balance": {
        "monetary": {
          "currency": "usd",
          "value": 1000
        },
        "type": "monetary"
      },
      "ledger_balance": {
        "monetary": {
          "currency": "usd",
          "value": 1000
        },
        "type": "monetary"
      }
    }
  ],
  "customer": "cus_QsEHa3GKweMwih",
  "livemode": false
}
```

## Returns

Returns the credit balance summary.

## Parameters

- [`filter`](https://docs.stripe.com/api/billing/credit-balance-summary/retrieve.md?query=filter) (object, required)
  The filter criteria for the credit balance summary.

- `customer` (string, optional)
  The customer whose credit balance summary you’re retrieving.

- `customer_account` (string, optional)
  The account representing the customer whose credit balance summary you’re retrieving.