How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Finicity

Finicity Institutions API

Search and fetch financial institutions

Documentation Provider Profile APIs.io OpenAPI GitHub

Finicity Institutions API is one of 41 APIs that Finicity publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Institutions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 6 paths, and defines 67 schemas. It is described by OpenAPI 3.2.0, at version 1.43.0.

Requests are made against a single base URL, https://api.finicity.com.

6 operations 6 paths 67 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.43.0
Base URL
https://api.finicity.com
Authentication
API Key, API Key
Contact
API Support
Resource Areas
1

Authentication & Security 2

Finicity Institutions API declares 2 security schemes for authenticating requests. An API key is passed in the header as Finicity-App-Key (FinicityAppKey). An API key is passed in the header as Finicity-App-Token (FinicityAppToken). By default, every request must be authenticated.

  • FinicityAppKey — The "Finicity-App-Key" from the developer dashboard
  • FinicityAppToken — A token returned by the /authentication API

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

Institutions 6

Search and fetch financial institutions

GET
/institution/v2/certifiedInstitutions/rssd
Get Certified Institutions With RSSD
GetCertifiedInstitutionsWithRSSD 5 params → 200400401
GET
/institution/v2/institutions
Get Institutions
GetInstitutions 5 params → 200400401
GET
/institution/v2/certifiedInstitutions
Get Certified Institutions
GetCertifiedInstitutions 5 params → 200400401
GET
/institution/v2/institutions/{institutionId}
Get Institution by ID
GetInstitution 1 param → 200400401404
GET
/institution/v2/institutions/{institutionId}/branding
Get Institution Branding by ID
GetInstitutionBranding 1 param → 200400401404
GET
/institution/v1/institutions/routingNumber/{routing_number}
Get Institutions by Routing Number
GetInstitutionsByRoutingNumber 1 param → 200400401404

Schemas 67

The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are InstitutionsWithRoutingNumber (43 properties), Institution (35 properties), CertifiedInstitution (16 properties), ErrorMessage (10 properties). Each schema is shown below with its type and property counts.

InstitutionTransAgg_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the Transaction Aggregation product for the institution. - online - prod…
ZipCode
string
A ZIP code
CertifiedInstitutions
object
A list of financial institutions from the Get Certified Institutions API
5 properties 5 required
Rssd
integer
The RSSD ID is a unique identifier assigned to financial institutions by the Federal Reserve. While the length of the RSSD ID varies by institution, it cannot…
InstitutionUrlLogonApp
string
The URL of the institution's login page
InstitutionOverallStatus
string
Beta Data - Can be ignored. The overall status for the institution: - online - Connection is active, financial institution is available and functioning - offli…
DisplayingResults
integer
The number of results returned
InstitutionAddress
object
The address of a financial institution
6 properties
EmailAddress
string
An email address
InstitutionStateAgg_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the Statement Aggregation product for the institution. - online - produc…
InstitutionTransAgg
boolean
"true": The institution is certified for the Transaction Aggregation product "false": The institution is decertified for the Transaction Aggregation product
AddressLine2
string
Address line 2
ChildInstitution
object
4 properties 4 required
Institution
object
A financial institution
35 properties 12 required
InstitutionDisplayName
string
A version of the institution connection name that is more user friendly
AddressLine1
string
Address line 1
BillPayDataCertification
boolean
billPayData is certified
BrandingWrapper
object
1 property 1 required
InstitutionSpecialInstructions
array
Instructions given to the customer before they are sent to the institution website to login for OAuth institutions. Note: this helps the customer to provide th…
InstitutionStateAgg
boolean
"true": The institution is certified for the Statement Aggregation product "false": The institution is decertified for the Statement Aggregation product
PhoneNumber
string
A phone number (max length 15).
ErrorMessage
object
10 properties 1 required
AccountId
string
An account ID
RoutingNumberInteger
integer
Routing number
InstitutionClass
string
Institution's class
InstitutionVoa_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the VOA product for the institution. - online - product is functioning c…
FoundResults
integer
The total number of results matching search criteria
InstitutionOverallStatusTemp
string
Beta Data - Can be ignored. Should use status field instead. The overall status for the institution: - online - Connection is active, financial institution is…
InstitutionAha_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the Account History Aggregation product for the institution. - online -…
InstitutionTimeZone
string
The time zone of the institution.
InstitutionAccountOwner
boolean
"true": The institution is certified for the Account Owner product "false": The institution is decertified for the Account Owner product
InstitutionVoa
boolean
"true": The institution is certified for the VOA product "false": The institution is decertified for the VOA product
InstitutionUrlOnlineRegistration
string
Institution's signup page
InstitutionProductionStatus
object
7 properties 7 required
InstitutionName
string
The name of the institution
Country
string
Country code is Iso3166-1 Alpha-2 code and Alpha 3 standard (max length 3).
InstitutionAch_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the ACH product for the institution. - online - product is functioning c…
InstitutionUrlForgotPassword
string
Institution's forgot password page
InstitutionStatus
string
Status for the institution: "online", "offline", "maintenance", "testing", "beta", "validated", "migrating"
PaymentInitiationCertification
boolean
Institution connection is certified for paymentInitiation
InstitutionVoi_status
string
Beta Data - Can be ignored. Should use status field instead. The production status for the VOI product for the institution. - online - product is functioning c…
MoreResultsAvailable
boolean
If the value of moreAvailable is "true", you can retrieve the next page of results by increasing the value of the start parameter in your next request:"...&sta…
InstitutionAvailableBalance
boolean
"true": The institution is certified for the Account Balance Check (ABC) product "false": The institution is decertified for the Account Balance Check (ABC) pr…
AssetId
string
An asset ID. Generated by Data Connect or by using the Store Customer Pay Statement API.
Institutions
object
A list of financial institutions from the Get Institutions API
5 properties 5 required
CertifiedInstitution
object
16 properties 4 required
InstitutionAch
boolean
"true": The institution is certified for the ACH product "false": The institution is decertified for the ACH product
Branding
object
All assets are SVGs so can be slightly resized without any issues.
5 properties
Currency
string
A currency code
InstitutionCountryCodes
array
StudentLoanDataCertification
boolean
"true": The institution is certified for the Student Loan Data product "false": The institution is decertified for the Student Loan Data product
NumericInstitutionId
integer
The ID of a financial institution, represented as a number
InstitutionVoi
boolean
"true": The institution is certified for the VOI product "false": The institution is decertified for the VOI product
InstitutionUrlHomeApp
string
The URL of the institution's primary home page
CertifiedInstitutionsWithRssd
object
A list of financial institutions from the Get Certified Institutions with RSSD API
5 properties 5 required
State
string
State
InstitutionSpecialText
string
Special instructions given to customers for login
InstitutionAccountTypeDescription
string
Values: Banking, Investments, Credit Cards/Accounts, Workplace Retirement, Mortgages and Loans, Insurance
InstitutionWrapper
object
1 property 1 required
InstitutionSpecialInstructionsTitle
string
The title of the special instructions, if one exists or is required.
LoanPaymentDetailCertification
boolean
"true": The institution is certified for the Loan Payment Detail product "false": The institution is decertified for the Loan Payment Detail product
InstitutionsWithRoutingNumber
object
List of institutions with matching routing numbers
43 properties
InstitutionAha
boolean
"true": The institution is certified for the Account History Aggregation product "false": The institution is decertified for the Account History Aggregation pr…
LiabilityDataCertification
boolean
liabilityData is certified
UnixDate
integer
A date in Unix epoch time (in seconds). See: [Handling Epoch Dates and Times](https://developer.mastercard.com/open-finance-us/documentation/errors/best-practi…
InstitutionOauthEnabled
boolean
"true": The institution is an OAuth connection "false": The institution isn't an OAuth connection
City
string
City

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

finicity-institutions-api-openapi.yml Raw ↑

Other APIs Finicity publishes across the network.

Finicity Connect
AE Profile APIs.io
Finicity Verification of Assets (VoA) API
AE Profile APIs.io
Finicity Verification of Income & Employment (VoIE) API
AE Profile APIs.io
Finicity Transaction Analysis (Cash Flow) API
AE Profile APIs.io
Finicity Payments (Account Validation) API
AE Profile APIs.io
Finicity Open Banking Data Access (FDX)
AE Profile APIs.io
Finicity Account Validation Assistance API
AE Profile APIs.io
Finicity Accounts API
AE Profile APIs.io
Finicity Accounts (Simple) API
AE Profile APIs.io
Finicity App Registration API
AE Profile APIs.io
Finicity Authentication API
AE Profile APIs.io
Finicity Balance Analytics API
AE Profile APIs.io
#Institutions
← Back to F APIs
API Details
ID
finicity:finicity-institutions-api
Base URL
https://api.finicity.com
Docs
https://developer.mastercard.com/open-banking-us/documentation/
Provider
Finicity
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=finicity-institutions-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/finicity-institutions-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Finicity Institutions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.