https://sandbox-products.ddp.akoya.com/accounts/{version}/{providerId}
Get detailed account information that includes Akoya products Account Info and Balances for all account types (annunity, deposit, insurance, investments, line of credit, and loan) and adds the Investments product to investment accounts including contributions, holdings, vesting information, and more.
To view the response schema, select the 200 response below. Then pick an option for annuity, deposit, insurance, investment, loan, and line of credit account types.
For an example payload response, see the 200 example response below the Try it feature. The example is from an investment account but all account types are supported and returned by this endpoint.
Use the mode query param to receive FDX-aligned, standardized data values (Beta). For example:
https://sandbox-products.ddp.akoya.com/accounts/v2/mikomo?mode=standard
mode is available in both sandbox and production.
mode is supported by a subset of providers. Log into the Data Recipient Hub and click here to view a list of all providers supporting the mode parameter.
version*
stringdefault: v2Akoya major version number. Do not use minor version numbers. For instance, use v2 and not v2.2
providerId*
stringdefault: mikomoId of provider
x-akoya-interaction-type
stringOptional but recommended header to include with each data request. Allowed values are `user` or `batch`. `user` indicates a request is prompted by an end-user action. `batch` indicates the request is part of a batch process.
mode
stringBETA. Default is raw. Use standard for FDX-aligned, standardized data values.
200
OK
Response Body
object
accounts
array of objects
An array of accounts with entity types dependent on the account type (deposit, investment, loan, line of credit, annuity or insurance)
Any of:
investmentAccount
holdings
array of objects
Array of holdings
assetClasses
array of objects
Percent breakdown by asset class.
object
assetClass
string
percent
number
Percentage of asset class that falls under this asset
averageCost
boolean
Cost is average of all purchases for holding.
cashAccount
boolean
If true, indicates that this holding is used to maintain proceeds from sales, dividends, and other cash postings to the investment account.
changeInPrice
number
Change in current price compared to previous day's close
currency
object
currencyCode
string
Iso 4217 currency code.
currencyRate
number
Currency rate between original and converted currency.
originalCurrencyCode
string
Iso 4217 currency code.
currentUnitPrice
number
currentUnitPriceDate
string
Current unit price as of date
description
string
Description of the holding
expirationDate
string
For CDs, bonds, and other time-based holdings.
faceValue
number
Required for bonds. Face value at the time of data retrieved.
fiAssetClasses
array of objects
Percent breakdown by FI-specific asset class percentage breakdown
object
assetClass
string
FI-specific asset class
percent
number
Percentage of asset class that falls under this asset
fiAttributes
array of objects
object
name
string
Name of attribute
value
string
Value of attribute
heldInAccount
string
Sub-account
holdingId
string
Long term persistent identity of the holding
holdingName
string
Holding name or security name
holdingSubType
string
holdingType
string
inv401kSurce
string
Source for money for this security.
marketValue
number
Market value at the time of data retrieved
originalPurchaseDate
string
Date of original purchase
positionType
string
purchasedPrice
number
Price of holding at the time of purchase
rate
number
For CDs, bonds, and other rate based holdings.
securityId
string
Unique identifier of security
securityIdType
string
Security identifier type
symbol
string
Ticker / Market symbol
taxLots
array of objects
Breakdown by tax lot.
object
costBasis
number
Total amount of money spent acquiring this lot including any fees or commission expenses incurred.
currentValue
number
Lot market value
originalPurchaseDate
string
Lot acquired date.
postionType
string
LONG, SHORT.
purchasedPrice
number
Original purchase price.
quantity
number
Lot quantity.
units
number
Required for stock, mutual funds. Number of shares (with decimals).
openOrders
array of objects
Array of open orders
object
orderId
string
Long term persistent identity of the order. Id for this order transaction.
securityId
string
Unique identifier of the security.
securityIdType
string
Security identifier type
symbol
string
Market symbol
description
string
Description of order
units
number
Number of units (shares, bonds, etc.)
orderType
string
Type of order.
orderDate
string
Order date
unitPrice
number
Unit price
unitType
string
Type of unit.
orderDuration
string
This order is good for DAY, GOODTILLCANCEL, IMMEDIATE
subAccount
string
limitPrice
number
Limit Price
stopPrice
number
Stop price
inv401kSource
string
For 401(k) accounts, source of money for this order. Default if not present is OTHERNONVEST.
contribution
array of objects
Array of contribution objects. Describes how new contributions are distributed among the available securities
object
securityId
string
Unique identifier of security
securityIdType
string
Security identifier type
employerMatchPercentage
number
Employer contribution match percentage
employerMatchAmount
number
Employer contribution match amount
employeePreTaxAmount
number
Employee pre‐tax contribution amount
employeePreTaxPercentage
number
Employee pre‐tax contribution percentage
employeeAfterTaxAmount
number
Employee after tax contribution amount
employeeAfterTaxPercentage
number
Employee after tax contribution percentage
employeeDeferPreTaxAmount
number
Employee defer pre‐tax contribution match amount
employeeDeferPreTaxPercentage
number
Employee defer pre‐tax contribution match percentage
employeeYearToDate
number
Employee total year to date contribution
employerYearToDate
number
Employer total year to date contribution
rolloverContributionPercentage
number
Rollover contribution percentage
rolloverContributionAmount
number
Rollover contribution Amount
vesting
array of objects
Array of vesting objects. Provides the past, present, and future vesting schedule and percentages
object
vestingDate
string
Vesting date
symbol
string
Security symbol
strikePrice
number
Strike price
vestingPercentage
number
Vesting percentage
otherVestAmount
number
Other vest amount
otherVestPercentage
number
Other vest percentage
vestedBalance
number
Vested balance
unVestedBalance
number
Unvested balance
vestedQuantity
number
Vested qualtity
unVestedQuantity
number
Unvested quantity
investmentLoans
array of objects
Array of investment loans
loanId
string
Unique identifier for this loan
loanDescription
string
Description
initialLoanBalance
number
Initial loan balance amount
loanStartDate
string
Start date of the loan
currentLoanBalance
number
Current loan principal balance amount
dateAsOf
string
Date and time of current loan balance
loanRate
number
Loan annual interest rate for the loan
loanPaymentAmount
number
Loan payment amount
loanPaymentFrequency
string
loanPaymentInitial
number
Initial number of loan payments
loanPaymentsRemaining
integer
Remaining number of loan payments
loanMaturityDate
string
Expected loan end date
loanInterestToDate
number
Total interest paid to date on this loan
loanTotalProjectedInterest
number
Total projected interest to be paid on this loan
loanNextPaymentDate
string
The next payment date for the loan
pensionSource
array of objects
Array of Pension Source
displayName
string
Name of the Source
amount
number
Benefit Amount
paymentOption
string
Form of payment
asOfDate
string
Date benefit was calculated
frequency
string
startDate
string
Assumed retirement date ‐ As of date amount is payable
equityGrants
array of objects
Provides equity grant information on Restricted Stock Units, Restricted Stock Awards, Stock Appreciation Right, Stock Options, Performance Awards, and Total Share Return Units
object
grantId
string
Unique identifier of grant
grantDate
string
Date grant was given
grantType
string
Type of grant
seqNum
number
grantPrice
number
Grant price
grantCurrencyCode
string
Indicates the currency of grant USD vs AUD vs EUR etc (for share awards, you will still get a USD)
quantityGranted
number
Number of options
quantityOutstanding
number
expirationDate
string
Date grant expires
vestings
array of objects
An array of equityGrant vestings. Provides the past, present, and future vesting schedule and percentages.
object
vestedQuantity
number
Vested quantity (Vested shares total qty of vesting tranche)
vestedValue
number
Vested balance at grant (aggregate of all vestings)
vestingDate
string
vestExpireDate
string
vestedStatus
string
depositAccount
balanceAsOf
string
As-of date of balances
openingDayBalance
number
Day's opening fund balance
availableBalance
number
Balance of funds available for use
interestYtd
number
YTD Interest
currentBalance
number
Balance of funds in account
loanAccount
balanceAsOf
string
As-of date of balances
escrowBalance
number
Escrow balance of loan
interestPaidYearToDate
number
Interest paid year to date
lastPaymentAmount
number
Last payment amount
lastPaymentDate
string
Last payment date
nextPaymentAmount
number
Amount of next payment
nextPaymentDate
string
Date of next payment
originalPrincipal
number
Original principal of loan
payOffAmount
number
Payoff amount
principalBalance
number
Principal balance of loan
locAccount
balanceAsOf
string
As-of date of balances
advancesApr
number
Advances APR
availableCash
number
Available cash
availableCredit
number
Available credit
cashAdvanceLimit
number
Cash advance limit
creditLine
number
Credit limit
currentBalance
number
Current balance LOC
currentRewardsBalance
number
Current rewards balance
financeCharges
number
Finance charges
lastPaymentAmount
number
Last payment amount
lastPaymentDate
string
Last payment date
lastStmtBalance
number
Last Statement Balance
lastStmtDate
string
Last Statement Date
minimumPaymentAmount
number
Minimum payment amount
nextPaymentAmount
number
Amount of next payment
nextPaymentDate
string
Due date of next payment
pastDueAmount
number
Past Due Amount
pointsAccrued
number
Points accrued
principalBalance
number
Principal balance
pointsRedeemed
number
Points redeemed
purchasesApr
number
Purchases APR
insuranceAccount
policyCoverageAmount
number
Total amount of money the user is insured for.
policyEndDate
string
The premium end date.
policyPremium
number
The amount of the user's premium.
policyPremiumTerm
string
he payment term for the premium. MONTHLY or ANNUAL.
policyStartDate
string
The premium start date.
annuityAccount
annualIncrease
number
Percent or dollar amount of annual payment increase
annualIncreaseType
string
netPresentValue
number
Surrender or cash balance value
paymentAmount
number
Amount of the recurring payment
paymentEndDate
string
Date last payment will be made
paymentStartDate
string
Date of first payment; could be a future date
periodCertainGuarantee
string
totalPaymentCount
number
Total number of payments that will be produced by the annuity
Headers
x-akoya-interaction-idstring
Akoya supplied interaction id used for logging and error tracking
206
Partial Content. Success searching for accounts. Some errors are being returned.
Response Body
object
accounts
array of objects
An array of accounts with entity types dependent on the account type (deposit, investment, loan, line of credit, annuity or insurance)
Any of:
depositAccount
balanceAsOf
string
As-of date of balances
openingDayBalance
number
Day's opening fund balance
availableBalance
number
Balance of funds available for use
interestYtd
number
YTD Interest
currentBalance
number
Balance of funds in account
loanAccount
balanceAsOf
string
As-of date of balances
escrowBalance
number
Escrow balance of loan
interestPaidYearToDate
number
Interest paid year to date
lastPaymentAmount
number
Last payment amount
lastPaymentDate
string
Last payment date
nextPaymentAmount
number
Amount of next payment
nextPaymentDate
string
Date of next payment
originalPrincipal
number
Original principal of loan
payOffAmount
number
Payoff amount
principalBalance
number
Principal balance of loan
locAccount
balanceAsOf
string
As-of date of balances
advancesApr
number
Advances APR
availableCash
number
Available cash
availableCredit
number
Available credit
cashAdvanceLimit
number
Cash advance limit
creditLine
number
Credit limit
currentBalance
number
Current balance LOC
currentRewardsBalance
number
Current rewards balance
financeCharges
number
Finance charges
lastPaymentAmount
number
Last payment amount
lastPaymentDate
string
Last payment date
lastStmtBalance
number
Last Statement Balance
lastStmtDate
string
Last Statement Date
minimumPaymentAmount
number
Minimum payment amount
nextPaymentAmount
number
Amount of next payment
nextPaymentDate
string
Due date of next payment
pastDueAmount
number
Past Due Amount
pointsAccrued
number
Points accrued
principalBalance
number
Principal balance
pointsRedeemed
number
Points redeemed
purchasesApr
number
Purchases APR
investmentAccount
availableCashBalance
number
Cash balance across all sub-accounts. Should include sweep funds.
balanceAsOf
string
As-of date of balances
balanceList
array of objects
Balance List. Name value pair aggregate.
object
balanceName
string
Name of the balance.
balanceDescription
string
Description of balance.
balanceType
string
The type of an investment balance. AMOUNT or PERCENTAGE.
balanceValue
number
Value of balance name.
balanceDate
string
Date as of this balance.
currency
object
currencyCode
string
Iso 4217 currency code.
currencyRate
number
Currency rate between original and converted currency.
originalCurrencyCode
string
Iso 4217 currency code.
currentValue
number
Total current value of all investments
dailyChange
number
Daily change
marginBalance
number
Margin balance
percentageChange
number
Percentage change
rolloverAmount
number
Rollover amount
shortBalance
number
Short balance
insuranceAccount
policyCoverageAmount
number
Total amount of money the user is insured for.
policyEndDate
string
The premium end date.
policyPremium
number
The amount of the user's premium.
policyPremiumTerm
string
he payment term for the premium. MONTHLY or ANNUAL.
policyStartDate
string
The premium start date.
annuityAccount
annualIncrease
number
Percent or dollar amount of annual payment increase
annualIncreaseType
string
netPresentValue
number
Surrender or cash balance value
paymentAmount
number
Amount of the recurring payment
paymentEndDate
string
Date last payment will be made
paymentStartDate
string
Date of first payment; could be a future date
periodCertainGuarantee
string
totalPaymentCount
number
Total number of payments that will be produced by the annuity
Headers
x-akoya-interaction-idstring
Akoya supplied interaction id used for logging and error tracking
400
401 - Invalid input
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
401
602 - Customer not authorized
Response Body
code
integer
message
string
404
701 - Tax Lots not found. The `holdingId` may be wrong.
Response Body
code
integer
message
string
406
1203 - Content Type not Supported
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
429
1207 - Too many requests
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
500
500 - Internal server error
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
501
1106 - Version not supported or not implemented
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
503
503 - System is down for maintenance
Response Body
object
code
integer
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
const options = {
"method": "GET",
"headers": {
"x-akoya-interaction-type": "batch"
}
}};
fetch('https://sandbox-products.ddp.akoya.com/accounts/v2/mikomo?mode=raw', options)
.then(response => response.json())
.catch(err => console.error(err));