---
title: "Get a grant account"
method: GET
path: "/grantAccounts/{id}"
tags: ["Grant accounts"]
deprecated: true
---

# Get a grant account

`GET /grantAccounts/{id}`

> **Deprecated.**

Returns the details of the [grant account](https://docs.adyen.com/platforms/capital#grant-account).

## Path parameters

- `id` string, required

## Response `200`

OK - the request has succeeded.

- CapitalGrantAccount
  - `balances` CapitalBalance[] — The balances of the grant account.
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
    - `fee` integer, required — Fee amount.
    - `principal` integer, required — Principal amount.
    - `total` integer, required — Total amount. A sum of principal amount and fee amount.
  - `fundingBalanceAccountId` string — The unique identifier of the balance account used to fund the grant.
  - `id` string — The identifier of the grant account.
  - `limits` GrantLimit[] — The limits of the grant account.
    - `amount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2025-09-09** (v2) `dd6159049c95` — 2 breaking
  - the `limits/items/amount/currency` response property's maxLength was unset from `3` for the response status `200`
  - the `limits/items/amount/currency` response property's minLength was decreased from `3` to `0` for the response status `200`
- **2025-02-14** (v2) `7ab1c2b70cc4` — 1 info
  - endpoint deprecated
- **2024-01-16** (v2) `24691235e721` — 1 info
  - the endpoint scheme security `clientKey` was added to the API
- **2023-11-14** (v2) `12a0c6036e6b` — 10 warning
  - removed the optional property `response/paths` from the response with the `400` status
  - removed the optional property `response/paths` from the response with the `401` status
  - removed the optional property `response/paths` from the response with the `403` status
  - removed the optional property `response/paths` from the response with the `422` status
  - …6 more

[Change history](https://skmtc.dev/adyen/apis/balanceplatformservice/changes/grantAccounts/:id/get.md)

---

[API](https://skmtc.dev/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.dev/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/balanceplatformservice/revisions/8761ac1a9aab/schema)