Akoya Products
Akoya products offer a wide breadth of solutions for your fintech needs that you can combine to cover a range of use cases.
Products
Account Information
Basic account information (included with all other products)
API Endpoint
/accounts-info/{version}/{providerId}
Summary
A list of accounts with basic info data
Replaces the FDX accounts lightweight concept
Supports all account categories
Typical Use Case
Populating an account selection screen for the consumer or high-level information for a list of accounts.
Response Data
A basic version of account info data elements such as accountType, productName, status, or currency.
Multiple accounts or query specific accounts
Balances
Balances and rates of bank accounts, credit cards, loans, investments, and more
Includes a common grouping of data and may contain additional data elements for annuity, deposit, insurance, investment, line of credit, or loan account categories.
API Endpoints
/balances/{version}/{providerId}
Summary
Account info and balances data
Typical Use Case
Displaying balance information to the consumer or conducting balance checks before initiating a payment
Response Data
Both account info and balances data elements such as accountType, currency, balanceAsOf, availableBalance, currentBalance, creditLine, or availableCredit.
Returns multiple accounts or query specific accounts
Supports all account categories
Investments
Detailed information on underlying holdings and positions of investment accounts.
While this endpoint is needed to retrieve extended data for the investment account category, you may also use it for other account categories (annuity, deposit, insurance, line of credit, or loans). If used for account categories other than investment, you will receive the same data as with the balances product.
API Endpoints
/accounts/[version}/{providerId}/
/taxlots/{version}/{providerId}/{accountId}/{holdingId}/
Summary
A comprehensive version of account info, balances, and investments data
Typical Use Case
Retrieve a comprehensive view of all account information for PFM or Wealth Management
Response Data
A comprehensive version of account info, balances, and investments data elements such as marginBalance, availableCashBalance, holdings (e.g., holdingType, symbol, units), or contribution (e.g., employerYearToDate, employeeYearToDate).
Returns multiple accounts or query specific accounts
Supports all account categories
Transactions
Up to two years of transaction data across account types, including amounts, dates, and descriptions.
Historical and current transactions, transaction types, amounts, dates and descriptions. All account categories except annuityAccount may include them.
API Endpoints
/transactions/{version}/{providerId}/{accountId}
Summary
All 200 responses return a pageLinks object with links (when applicable) for paging backward and forward in results.
Response Data
From a single account, a list of transactions data elements such as transactionId, postedTimestamp, description, category, amount, or transactionType.
Customers
Verified contact information on file, including name, email, address, and phone number.
This endpoint returns information on account holders for the accounts permissioned by the consumer.
API Endpoints
/customers/{version}/{providerId}/current
/contacts/{version}/{providerId}/{accountId}
Summary
All 200 responses will return a pageLinks object with links (when applicable) for paging backward and forward in results.
Response Data
Customer info related data elements such as name, email, addresses, telephones, or relationships (i.e., account holder relationship to an account)
Returns consumer information which is not account category specific.
Payments
Identifiers necessary to make ACH and RTP payments.
The Payments product returns both account and bank routing numbers, as well as other crucial identifiers.
API Endpoints
/payments/{version}/{providerId}/{accountId}/payment-networks
Response Data
Payment network related data elements such as bankId (i.e., routing number), identifier (i.e., account number), identifierType (e.g., tokenized account number), or type (e.g., US_ACH, US_RTP)
Returns a single account
Supports all applicable account categories
Statements
List of financial institution statements available to download.
API Endpoints
/statements/{version}/{providerId}/{accountId}
/statements/{version}/{providerId}/{accountId}/{statementId}
Summary
Allows retrieval of statements for your consumer's consented accounts (up to two years of historical statements, depend on provider)
The Statements List endpoint returns an array of available statements with high level information of statement meta data including the link to retrieve each statement.
The Statements endpoint gets an individual statement, identified by statementId, in PDF, GIF, JPG, TIFF, or PNG format.
Responses
Akoya products returns results in JSON format following FDX data structures.
Partial Response Coverage
When supported by the provider, Akoya may return HTTP 206 partial responses for the following endpoints:
/account-info
/balances
/accounts
Reasons for a Partial Response
Account error. Error retrieving data for some accounts.
Timeout. Partial retrieval of all requested accounts before the request times out.
Account Error
A partial response contains all requested accounts. The response includes accounts with unretrievable data with an error element in addition to the account identifier.
Example:
JSON
Timeout
When a request exceeds the timeout threshold, the 206 partial response includes a 1207 error.
After receiving a 1207 error code, consider issuing follow-up requests for the accounts the original timed-out response did not return.
Example: