---
title: "Get a capital account"
method: GET
path: "/grants"
tags: ["Capital"]
---

# Get a capital account

`GET /grants`

Returns a list of grants with status and outstanding balances.

## Query parameters

- `counterpartyAccountHolderId` string

## Response `200`

OK - the request has succeeded.

- CapitalGrants
  - `grants` CapitalGrant[], required — The unique identifier of the grant.
    - `amount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
      - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `balances` CapitalBalance, required
      - `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.
    - `counterparty` Counterparty2
      - `accountHolderId` string — The identifier of the receiving account holder. The payout will default to the primary balance account of this account holder if no `balanceAccountId` is provided.
      - `balanceAccountId` string — The identifier of the balance account that belongs to the receiving account holder.
      - `transferInstrumentId` string — The identifier of the transfer instrument that belongs to the legal entity of the account holder.
    - `fee` Fee
      - `amount` Amount, required
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `grantAccountId` string, required — The identifier of the grant account used for the grant.
    - `grantOfferId` string, required — The identifier of the grant offer that has been selected and from which the grant details will be used.
    - `id` string, required — The identifier of the grant reference.
    - `repayment` Repayment
      - `basisPoints` integer, required — The repayment that is deducted daily from incoming net volume, in [basis points](https://www.investopedia.com/terms/b/basispoint.asp).
      - `term` RepaymentTerm
        - `estimatedDays` integer, required — The estimated term for repaying the grant, in days.
        - `maximumDays` integer — The maximum term for repaying the grant, in days. Only applies when `contractType` is **loan**.
      - `threshold` ThresholdRepayment
        - `amount` Amount, required
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `status` 'Pending' | 'Active' | 'Repaid', required — The current status of the grant. Possible values: **Pending**, **Active**, **Repaid**.

## Other responses

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

## Changes

- **2023-06-20** (v3) `e9eb8c599a57` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/transferservice/changes/grants/get.md)

---

[API](https://skmtc.dev/adyen/apis/transferservice.md) · [All operations](https://skmtc.dev/adyen/apis/transferservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/transferservice/revisions/8bddc097c74e?raw)