Get all the grants of an account holder

get/grants

API Version

Returns a list of all the grants of a specific account holder.

Endpoint destination URL

Query Parameters

Required

Optional

The unique identifier of the account holder that received the grants.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
The request has succeeded.
grantsarray[object]
Contains a list of the grants that the account holder has received.
amountobject
Contains information about the amount of the grant. This is the sum of the amounts of all the disbursements related to the grant.
currencystring
The three-character ISO currency code.
valueinteger
The amount of the transaction, in minor units.
balancesobject
Contains information about the balances of the grant.
currencystring
The three-character ISO currency code.
feeinteger
The amount of the grant fee.
principalinteger
The grant amount that is paid out to the user for business financing.
totalinteger
The total amount of the grant that the user must repay. It is the sum of the fee amount and the principal amount.
counterpartyobject
Contains the details of the party that receives the grant. Setting either an accountHolderId, balanceAccountId, or both is required.
accountHolderIdstring
The unique identifier of the account holder that receives the grant. If no balanceAccountId is provided, the grant funds are disbursed to the primary balance account of this account holder.
balanceAccountIdstring
The unique identifier of the balance account where the funds are disbursed. The balance account must belong to the specified account holder.
transferInstrumentIdstring
The unique identifier of the transfer instrument where the funds are disbursed. The transfer instrument must belong to the legal entity of the specified account holder.
feeobject
Contains information about the fee that your user must pay for the grant. This is the sum of the fees of all the disbursements related to the grant.
amountobject
Contains the amount of the grant fee.
currencystring
The three-character ISO currency code.
valueinteger
The amount of the transaction, in minor units.
grantAccountIdstring
The unique identifier of the grant account that tracks this grant.
grantOfferIdstring
The unique identifier of the selected grant offer. Adyen uses the details of the selected grant offer to create a grant.
idstring
The unique identifier of the grant reference.
repaymentobject
Contains information about the repayment configuration of the grant. By default, this repayment configuration applies to all the disbursements related to the grant.
basisPointsinteger
The percentage of your user's incoming net volume that is deducted for repaying the grant. The percentage expressed in basis points.
termobject
Contains information about the time period in which your user must repay the total amount of the grant.
estimatedDaysinteger
The estimated duration of the repayment term, in days.
maximumDaysinteger
The maximum duration of the repayment term, in days. Only applies when contractType is loan.
thresholdobject
Contains the minimum threshold amount that your user must repay every 30-day period.
amountobject
The minimum threshold amount that your user must repay on every 30-day period.
currencystring
The three-character ISO currency code.
valueinteger
The amount of the transaction, in minor units.
statusobject
Contains the status of the grant.
code
The code for the status of the grant. Possible values:

Pending

Active

Repaid

WrittenOff

Failed

Revoked
404 - Not Found
The entity was not found.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
422 - Unprocessable Entity
A request validation error.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.

Get all the grants of an account holder

HTTP Responses

200 - OK

404 - Not Found

422 - Unprocessable Entity