Get all available static offers

get/grantOffers

API Version

Returns a list of all static offers available for accountHolderId specified as a query parameter. This also includes static offers created for financing amounts that the user selected from dynamic offers.

Endpoint destination URL

Query Parameters

Required

Optional

The unique identifier of the account holder for which you want to get the available static offers.

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.
grantOffersarray[object]
Contains a list of available offers for the specified account holder.
accountHolderIdstring
The unique identifier of the account holder to which the grant is offered.
amountobject
The amount that would be paid out to the user for business financing.
currencystring
The three-character ISO currency code of the amount.
valueinteger
The numeric value of the amount, in minor units.
contractTypestring
The contract type of the offer.

Possible values:

loan

cashAdvance

expiresAtstring
The expiration date and time of the offer validity period.
feeobject
Contains information about the fee that your user would pay for the grant.
amountobject
Contains the amount of the offer fee.
currencystring
The three-character ISO currency code of the amount.
valueinteger
The numeric value of the amount, in minor units.
aprBasisPointsinteger
Annual Percentage Rate (APR) of the offer. The percentage is expressed in basis points.
idstring
The unique identifier of the offer.
repaymentobject
Contains information about the repayment configuration of 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 of the amount.
valueinteger
The numeric value of the amount, in minor units.
startsAtstring
The starting date and time of the offer validity period.
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.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
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.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
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 available static offers

HTTP Responses

200 - OK

404 - Not Found

422 - Unprocessable Entity