Getting Started - Illumia Documentation

Overview

The Institution Management APIs let authorized integrators look up cardholder, account, credential, and transaction information for campus applications through the IDX platform. They provide a secure, read-oriented interface for retrieving cardholder identity and account data scoped to a single institution.

Who is this for?

These APIs are designed for campus technology partners who need to retrieve cardholder data as part of a campus app integration. Common use cases include:

Campus mobile apps that display a student’s credential information, meal plan balances, or account status.
Third-party systems that verify cardholder identity or retrieve account details for downstream workflows.
Institutional IT teams building custom integrations between IDX credentials and other campus platforms.

APIs included

Documentation	Description
Cardholder API	Create, retrieve, update, and delete cardholder records, and manage cardholder photos.
Credential API	Retrieve and update a cardholder’s credentials, and list the credential types, value types, and value pools configured for the institution.
Lookup API	Find a cardholder’s unique identifier and related information by their `customerId`.
Cardholder Account API	Retrieve a cardholder’s accounts, account balances, and transaction history.

This guide is the shared onboarding entry point for the Institution Management APIs. Authentication, error responses, HTTP status codes, and pagination behave the same way across every API in this group and are documented once in the Introduction section.

Quick start

1. Obtain your API credentials

Access to the Institution Management APIs requires a valid subscription key. Request a key through your campus card office administration.

2. Set your base URL

All requests are routed through the IDX API gateway. Each API has its own versioned base path.

API	Environment	Base URL
Cardholder	UAT	`https://api-uat.transactsp.net/idx/institution-management/cardholders/v1`
Cardholder	Production	`https://api.transactcampus.com/idx/institution-management/cardholders/v1`
Credential	UAT	`https://api-uat.transactsp.net/idx/institution-management/credentials/v1`
Credential	Production	`https://api.transactcampus.com/idx/institution-management/credentials/v1`
Lookup	UAT	`https://api-uat.transactsp.net/idx/institution-management/lookups/v1`
Lookup	Production	`https://api.transactcampus.com/idx/institution-management/lookups/v1`
Cardholder Account	UAT	`https://api-uat.transactsp.net/idx/institution-management/cardholders-accounts/v1`
Cardholder Account	Production	`https://api.transactcampus.com/idx/institution-management/cardholders-accounts/v1`

3. Authenticate your request

Include your subscription key in the Ocp-Apim-Subscription-Key header on every request:

GET /idx/institution-management/cardholders/v1/cardholders/{cardholderId} HTTP/1.1
Host: api.transactcampus.com
Ocp-Apim-Subscription-Key: your-subscription-key-here

4. Make your first call

Retrieve a cardholder by ID:

curl -X GET "https://api.transactcampus.com/idx/institution-management/cardholders/v1/cardholders/755a459f-ed84-46f3-a341-33f9fb83ba02" \
  -H "Ocp-Apim-Subscription-Key: your-subscription-key-here"

A successful response returns the cardholder record:

{
  "cardholderId": "755a459f-ed84-46f3-a341-33f9fb83ba02",
  "customerId": "A12345",
  "cardholderActiveState": true,
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane.doe@university.edu",
  "hasPhoto": true
}

UAT data is synthetic and may be reset periodically. Do not send real cardholder information in UAT requests.

What’s next?

Review Authentication for key management and rate limit policies.
Review Error Responses and HTTP Status Codes to build robust error handling.
Review Pagination before working with list endpoints.
Browse the API references in the sidebar for full request and response schemas, parameter details, and additional endpoints.

Support

For questions about API access, integration guidance, or to report an issue, contact your campus card office. Document Version: 1.0
Last Updated: August 2026
© Illumia Inc. - Confidential

​Overview

​Who is this for?

​APIs included

​Quick start

​1. Obtain your API credentials

​2. Set your base URL

​3. Authenticate your request

​4. Make your first call

​What’s next?

​Support

Overview

Who is this for?

APIs included

Quick start

1. Obtain your API credentials

2. Set your base URL

3. Authenticate your request

4. Make your first call

What’s next?

Support