---
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#currency-codes).
    - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `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#currency-codes).
      - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `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#currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `status` 'Pending' | 'Active' | 'Repaid' | 'Failed' | 'WrittenOff' | 'Revoked', required — The current status of the grant. Possible values: **Pending**, **Active**, **Repaid**, **WrittenOff**, **Failed**, **Revoked**.

## 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

- **2025-03-04** (v3) `bc888fe170cf` — 3 warning
  - added the new `Failed` enum value to the `status` response property for the response status `200`
  - added the new `Revoked` enum value to the `status` response property for the response status `200`
  - added the new `WrittenOff` enum value to the `status` response property for the response status `200`
- **2025-03-04** (v3) `6f904aa6b803` — 3 info
  - removed the `Failed` enum value from the `status` response property for the response status `200`
  - removed the `Revoked` enum value from the `status` response property for the response status `200`
  - removed the `WrittenOff` enum value from the `status` response property for the response status `200`
- **2025-03-04** (v3) `bc888fe170cf` — 3 warning
  - added the new `Failed` enum value to the `status` response property for the response status `200`
  - added the new `Revoked` enum value to the `status` response property for the response status `200`
  - added the new `WrittenOff` enum value to the `status` response property for the response status `200`
- **2025-03-04** (v3) `6f904aa6b803` — 3 info
  - removed the `Failed` enum value from the `status` response property for the response status `200`
  - removed the `Revoked` enum value from the `status` response property for the response status `200`
  - removed the `WrittenOff` enum value from the `status` response property for the response status `200`
- …earlier changes not shown

[Full 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-service-production.skmtc.workers.dev/v1/apis/adyen/transferservice/revisions/bc888fe170cf/schema)