Skip to main content

Akoya
Documentation

Accounts

GET

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.


Path Parameters

  1. version*

    stringdefault: v2

    Akoya major version number. Do not use minor version numbers. For instance, use v2 and not v2.2

  2. providerId*

    stringdefault: mikomo

    Id of provider

Headers

  1. x-akoya-interaction-type

    string

    Optional 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.

Query Parameters

  1. mode

    string

    BETA. Default is raw. Use standard for FDX-aligned, standardized data values.


Responses

  1. 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

                      DOMESTICBONDINTLBONDLARGESTOCKSMALLSTOCKINTLSTOCKMONEYMARKETOTHER

                      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

                  CASHMARGINSHORTOTHER

                  holdingId

                  string

                  Long term persistent identity of the holding

                  holdingName

                  string

                  Holding name or security name

                  holdingSubType

                  string

                  MONEYMARKETCASH

                  holdingType

                  string

                  STOCKBONDMUTUALFUNDCDANNUITYOPTIONOTHER

                  inv401kSurce

                  string

                  Source for money for this security.

                  PRETAXAFTERTAXMATCHPROFITSHARINGROLLOVEROTHERVESTOTHERNONVEST

                  marketValue

                  number

                  Market value at the time of data retrieved

                  originalPurchaseDate

                  string

                  Date of original purchase

                  positionType

                  string

                  LONGSHORT

                  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

                  CUSIPISINSEDOLSICCVALORWKN

                  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.

                      LONGSHORT

                      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

                  CUSIPISINSEDOLSICCVALORWKN

                  symbol

                  string

                  Market symbol

                  description

                  string

                  Description of order

                  units

                  number

                  Number of units (shares, bonds, etc.)

                  orderType

                  string

                  Type of order.

                  BUYSELLBUYTOCOVERBUYTOOPENSELLTOCOVERSELLTOOPENSELLSHORTSELLCLOSE

                  orderDate

                  string

                  Order date

                  unitPrice

                  number

                  Unit price

                  unitType

                  string

                  Type of unit.

                  CURRENCYSHARES

                  orderDuration

                  string

                  This order is good for DAY, GOODTILLCANCEL, IMMEDIATE

                  DAYGOODTILLCANCELIMMEDIATE

                  subAccount

                  string

                  CASHMARGINSHORTOTHER

                  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.

                  AFTERTAXMATCHOTHERNONVESTOTHERVESTPRETAXPROFITSHARINGROLLOVER

              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

                  CUSIPISINSEDOLSICCVALORWKN

                  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

                  WEEKLYBIWEEKLYTWICEMONTHLYMONTHLYFOURWEEKSBIMONTHLYQUARTERLYSEMIANNUALLYANNUALLYOTHER

                  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

                  ANNUALLYBIWEEKLYDAILYMONTHLYSEMIANNUALLYSEMIMONTHLYWEEKLY

                  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.

              MONTHLYANNUAL

              policyStartDate

              string

              The premium start date.

          annuityAccount

              annualIncrease

              number

              Percent or dollar amount of annual payment increase

              annualIncreaseType

              string

              FIXEDPERCENTDOLLAR

              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

              NO PERIOD CERTAIN5-YEAR10-YEAR20-YEAR30-YEAR

              totalPaymentCount

              number

              Total number of payments that will be produced by the annuity

    Headers

    1. x-akoya-interaction-idstring

      Akoya supplied interaction id used for logging and error tracking

  2. 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.

                  AMOUNTPERCENTAGE

                  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.

              MONTHLYANNUAL

              policyStartDate

              string

              The premium start date.

          annuityAccount

              annualIncrease

              number

              Percent or dollar amount of annual payment increase

              annualIncreaseType

              string

              FIXEDPERCENTDOLLAR

              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

              NO PERIOD CERTAIN5-YEAR10-YEAR20-YEAR30-YEAR

              totalPaymentCount

              number

              Total number of payments that will be produced by the annuity

    Headers

    1. x-akoya-interaction-idstring

      Akoya supplied interaction id used for logging and error tracking

  3. 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

  4. 401

    602 - Customer not authorized

    Response Body

      code

      integer

      message

      string

  5. 404

    701 - Tax Lots not found. The `holdingId` may be wrong.

    Response Body

      code

      integer

      message

      string

  6. 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

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

  8. 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

  9. 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

  10. 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

CTRL + K

Try it

Authorization

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));