Developer Programs
Fintech Integration Network (FIN)
Jack Henry's Integration Program for Fintechs.
Technical Account Manager (TAM)
Get technical integration help from a single point of contact.
Developer Account
Create a developer acccount to access resources that help you integrate with Jack Henry.
Learn
Shared Responsibility
Learn about shared roles and responsibilities of customers and Jack Henry in open banking.
Developer Use Cases
Find a use case that fits your development needs.
Developer Video Gallery
Watch the latest demos, webinars, and more.
Developer Conference
Connect with industry leaders, gain insights from expert speakers, and explore our latest innovations.
Docs
Admin API
Create solutions for an institution's back office support tools.
Authentication Framework
Map customer identities to your existing system IDs.
Consumer API
Access financial data for user accounts, transactions, and more.
Data Hub
Get deeper access to financial institution data.
Enterprise Event System
Respond to events in real-time using this powerful pub/sub-based solution.
jXchange - REST API
Translate business information between Jack Henry and 3rd-party apps using a REST-based API.
jXchange - SOAP API
Translate business information between Jack Henry and 3rd-party apps using a SOAP-based API.
Operational Data Integration (ODI)
Get customized queries for bulk data needs.
Payments
Embed check deposits, ACH, bill pay, cards, and real-time payments.
Plugin Framework
Embed the best of the fintech world directly into your user's dashboard.
SymXchange
Query Symitar core member accounts, post transactions, run PowerOn scripts, and more.
Xperience
Modern UI that provides consistent visual integration across Jack Henry products.
Full List of APIs
Begin working with Jack Henry's public APIs to build financial applications today.

Institution Universal ID

Getting Started > Institution Universal ID

What is “Institution Universal ID”?

An Institution Universal Id (InstUID) is a value in the form of a GUID that represents a customer definition or configuration and provides a way to identify the route to a Product API regardless of how granular the definition of the customer environment/configuration. This InstUID will be used in JX REST APIs (v2) and replace the currently used ‘Institution’ and ‘Environment’. This will both reduce the complexity of the URL and improve the granularity available to Jack Henry Products to define the customer’s configurations.

V1 and V2 Comparison

Currently, the API (v1) design pattern for routing is as follows: /v1/institutions/{InstitutionRoutingId}/environments/{InstitutionEnvironment}/products/{ProductId}/…product resource info… InstitutionRoutingId = ABA, InstitutionEnvironment=[Prod, Beta, Test, …], ProductId = ‘jha-prodname’

The use of Institution Universal ID will change the API design pattern for routing to (v2): /v2/ {InstitutionUniversalId}/{ProductId}/…product resource info… InstitutionUniversalId = Commonly defined Universal Identity as a GUID, ProductId = ‘jha-prodname’

By using an Institution Universal ID, instead of ABA + Environment, this allows Jack Henry Products to create a unique ID for any combination or requirement of a complex customer configuration. The definition of the Universal ID can be as detailed as needed in supporting the varying customer configurations by adding metadata (brand, bank-number, bank-id, etc.) describing the uniqueness. Once a customer configuration is registered and an Institution Universal ID is assigned, it is expected that all other Jack Henry Products that have the same customer configuration WILL support the same InstUID to provide a customer configuration commonality among Products for use in API access.

Obtaining the Institution Universal ID

You will receive the InstUID value when you receive your client id, but this can also be found in the decoded JWT access token in the “instuid” property. If you do not receive the “instuid” property in your access token, it means you have a V1 client and will need to be issued a new V2 client in order to utilize the V2 URL structure.

Have a Question?
Have a how-to question? Seeing a weird error? Get help on StackOverflow.
Register for the Developer Office Hours where we answer technical Q&A from the audience.
Did this page help you?
Last updated Fri Feb 28 2025