> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve GPA balances

> Use this endpoint to return general purpose account (GPA) balances for a user or a business.

GET/balances/\{token}

Use this endpoint to return general purpose account (GPA) balances for a user or a business. The response object includes a link to balances of related user GPAs.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the user or business for which you want to return GPA balances. **Allowable Values:**  Existing user or business resource token |

## Response body

| Fields | Description |
| - | - |
| gpa object  Returned | Returns general purpose account (GPA) balances for a user or business. **Allowable Values:**  `available_balance`, `balances`, `cached_balance`, `credit_balance`, `currency_code`, `impacted_amount`, `last_updated_time`, `ledger_balance`, `pending_credits` |
| gpa.**available\_balance** decimal  Returned | Ledger balance minus any authorized transactions that have not yet cleared. Also known as the cardholder's purchasing power. When using JIT Funding, this balance is usually equal to \$0.00. **Allowable Values:**  Format: 0.00 |
| gpa.**balances** object  Returned | Contains GPA balance information, organized by currency code. **Allowable Values:**  One or more balances objects |
| gpa.**cached\_balance** decimal  Returned | Not currently in use. **Allowable Values:**  Not applicable |
| gpa.**credit\_balance** decimal  Returned | Not currently in use. **Allowable Values:**  Not applicable |
| gpa.**currency\_code** string  Returned | Three-digit ISO 4217 currency code. **Allowable Values:**  Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). |
| gpa.**impacted\_amount** decimal  Conditionally returned | Balance change based on the amount of the transaction. **Allowable Values:**  Format: 0.00 |
| gpa.**last\_updated\_time** datetime  Returned | Date and time when the resource was last updated, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| gpa.**ledger\_balance** decimal  Returned | When using standard funding: The funds that are available to spend immediately, including funds from any authorized transactions that have not yet cleared. When using Just-in-Time (JIT) Funding: Authorized funds that are currently on hold, but not yet cleared. **Allowable Values:**  Format: 0.00 |
| gpa.**pending\_credits** decimal  Returned | ACH loads that have been accepted, but for which the funding time has not yet elapsed. **Allowable Values:**  Format: 0.00 |
| links array of objects  Returned | Array of links to balances of related user GPAs. **Allowable Values:**  Valid array of one or more `links` objects |
| links\[].**href** string  Returned | URL of the requested `/balances` resource. **Allowable Values:**  A valid URL |
| links\[].**method** string  Returned | The HTTP method of the link. **Allowable Values:**  `GET` currently supported |
| links\[].**rel** string  Returned | Specifies the relationship between the current resource and the linked resource. **Allowable Values:**  `gpa` currently supported |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "gpa": {
    "currency_code": "USD",
    "ledger_balance": 1000,
    "available_balance": 990,
    "pending_credits": 0,
    "balances": {
      "USD": {
        "currency_code": "USD",
        "ledger_balance": 1000,
        "available_balance": 990,
        "pending_credits": 0
      }
    }
  },
  "links": {
    "rel": "gpa",
    "method": "GET",
    "href": "/v3/balances/my_user_01/gpa"
  }
}
```


## Related topics

- [Balances Overview](https://www.marqeta.com/docs/core-api/balances.md)
- [Retrieve GPA unload](https://www.marqeta.com/docs/core-api/gpa-orders/gpa-unloads/retrieve-unload.md)
- [Retrieve GPA order](https://www.marqeta.com/docs/core-api/gpa-orders/retrieve-gpa-order.md)
- [Activity Balances](https://www.marqeta.com/docs/diva-api/activity-balances.md)
- [Retrieve reward account balances](https://www.marqeta.com/docs/core-api/credit-reward-accounts/retrieve-balances.md)