---
title: "Get grant reference details"
method: GET
path: "/grants/{id}"
tags: ["Capital"]
---

# Get grant reference details

`GET /grants/{id}`

Returns the details of a capital account specified in the path.

## Path parameters

- `id` string, required

## Response `200`

OK - the request has succeeded.

- CapitalGrant
  - `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` Counterparty
    - `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-10-27** (v3) `073f244a0263` — 12 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 `404` status
  - …8 more
- **2023-06-20** (v3) `e9eb8c599a57` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/transferservice/changes/grants/:id/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/073f244a0263?raw)