My apps

📘

Up to 10 sandbox apps allowed

You’re allowed to have up to 10 apps in our sandbox environment at a time.

Viewing your apps

Apps are organized by environment. Click on the “Sandbox” or “Production” buttons to view apps in each environment.

🚧

Onboarding required before registering apps in production

You must request production access and fill out our onboarding questionnaire before registering apps in production.

Registering sandbox apps

Click “Register sandbox app” to kick off the registration wizard. You’ll need to have the following information to complete registration:

• Display name
• Description
  • a description of your app
• Logo URL
  • We recommend using your full logo. We use this image for your end-user consent page. If you don’t have a dedicated app logo, you can use your company logo instead.
  • accepted width & height: 200px - 1024px (square or rectangular)
  • accepted file types: transparent PNG or JPG
  • maximum file size: 2 MB
• Icon URL (optional)
  • We recommend using a sub-mark logo. We use this image as an avatar for your app in the Hub.
  • accepted size: 40px - 200px (square)
  • accepted file types: transparent PNG or JPG
  • maximum file size: 2 MB
• “Contact us” URL
  • This is your company or app’s "Contact us" page.
• Contact email address
  • Emails from our support team regarding this app and any support cases will go to the address listed here. To ensure the correct parties receive these emails, we recommend using an email distribution list.
• Redirect URI(s)
• Product selection
  • Select the Akoya products that this specific app will use. The Account Info product is always included. See “Akoya Products” to learn more about our products and their use cases.
• Provider selection
  • The financial institutions you select will receive a request to allow your app to access their customers' data post-consent. Processing time varies by provider from a few days to a few weeks. Supported Akoya products will be listed next to each provider.
  • Your selections will persist as you move through the paginated results. The search box and vertical ellipses will allow you to search for specific providers, or filter providers matching certain criteria. See the “Searching and filtering” section under “Data providers” for more info on how the filtering feature works.

Your new app will show up on the “My apps” page after registration is complete. The first time you view this page, a button will display to the right of the client secret field allowing you to download your credentials. As with a sandbox app, this download button will only appear once. If you lose your client secret, you will have to reset it.

A sandbox app entity will appear, along with a randomly-generated client ID and placeholder redirect URI that you can modify later. See “Getting started” for more information about redirect URIs.

Request production access

When you’re ready to move your first app into production, clicking the “Request production access” option in the left navigation bar will trigger our onboarding questionnaire.

This form covers several topics, including:

• Use cases
• How your company consumes financial data
• Actual and anticipated API call volume
• Number of users supported
• Technical readiness
• Security controls

🚧

Form progress cannot be saved!

If you navigate away from the form before clicking the “Submit” button, your progress will be lost. If desired, you can download a PDF copy of the form to pre-plan your answers.

After you submit the questionnaire, you’ll be taken to a confirmation screen. You’ll also receive an email confirmation with a reference number should you have any questions.

Our staff will review your submission and reach out to you regarding next steps.

Registering production apps

After you've been granted production access, the “Register a production app” button will be available in “My apps.” The process to register a new production app is similar to that of a sandbox app.

Viewing/modifying app details

The “Details” tab displays the following information and functionality:

• App name (display name) [view]
• Client ID [view]
• Client secret [reset]
  • We do not display client secrets for security reasons.
• Akoya products [view]
  • These are the Akoya products enabled for your application.
• Redirect URI(s) [view, edit]
• Description [view, edit]
• Contact URL [view, edit]
• Primary logo URL [view, edit]
• Icon/avatar URL [view, edit]
• Support email(s) [view, edit]
• Creation date [view]

Resetting your client secret

Click the reset icon next to the "Client secret" line item.

You’ll receive a warning message about potential service disruption after the reset. A button will appear, allowing you to download your new client secret. The screenshot below shows a sandbox app, but the process is the same for a production app.

Modifying your redirect URI

If you’re adding multiple URIs, separate each one with a comma and click “Save.”

Modifying logo and icon URLs

The app logo and icon requirements are discussed in the "Registering sandbox apps" section. Requirements for company and app logos/icons are the same.

Modifying support email(s)

Click the pencil icon next to “Support emails” to edit (near the bottom of the page).

Search apps

Search box

Search for a sandbox or production app by display name or client ID. Results will display in the window as you type.

Viewing/adding providers

The “Subscriptions” tab displays all your subscribed providers, subscription statuses, and which Akoya products are enabled. For your sandbox testing app, the only provider will be our mock financial institution, Mikomo.

Once your app is in production, you can also request new provider subscriptions from the "Subscriptions" tab.

Add a provider

Click the "Add subscriptions" button shown above.

Check the box(es) next to the provider(s) you want to subscribe to, and click "Request subscriptions." Refer to "Registering sandbox apps" for details on how to search and filter the provider list as you select additional subscriptions.

Provider subscription statuses

Your app status will display next to the provider in the “Subscriptions” tab and may include the following:

Clicking on a provider will take you directly to that provider’s documentation and inventory page. This area is discussed further in the "Data Providers" section.

There, you can view specific documentation pertaining to that provider, organized into tabs. The provider pages will be discussed in the next section.

Export subscription data

You can export a complete or filtered provider subscription list to CSV or JSON.

CSV supported fields

JSON supported data elements

Example

Below are sample CSV and JSON exports.

📘

Note

The actual JSON export is unbeautified. The example below has been formatted for easier viewing.

provider_name,provider_id,subscription_status,supported_products
Mikomo,mikomo,PENDING,"account_info,investments,payments,balances,customers,transactions"

{
  "pending": [
    {
      "id": "mikomo",
      "displayName": "Mikomo",
      "clusters": [
        {
          "id": "18owqx33-uf6p-4yhs-hxyf-yiwf9d9lx3em",
          "name": "transactions",
          "description": "Up to two years of transaction data across account types, including amounts, dates, and descriptions.",
          "required": false
        },
        {
          "id": "ex4f8efr-449e-2g5f-vg16-td95mceyl52r",
          "name": "account_info",
          "description": "Account display name, masked account number, type, description.",
          "required": true
        },
        {
          "id": "svm024fm-hvg6-n7x0-dpw4-e0tx9vi1ctjd",
          "name": "investments",
          "description": "Detailed information on underlying holdings and positions of investment accounts.",
          "required": false
        },
        {
          "id": "lqxoc2ha-odfj-qgr2-d719-1ttpnecb4bes",
          "name": "payments",
          "description": "Identifiers necessary to make ACH and RTP payments.",
          "required": false
        },
        {
          "id": "srep6cnk-ze4m-khcx-8cfz-brm86qg6ealb",
          "name": "balances",
          "description": "Balances and rates of bank accounts, credit cards, loans, investments, and more.",
          "required": false
        },
        {
          "id": "6sc1b2sa-36z4-gccp-711z-r0o817nhrufz",
          "name": "customers",
          "description": "Verified contact information on file, including name, email, address, and phone number.",
          "required": false
        }
      ],
      "subscriptionStatus": "PENDING"
    }
  ],
}