Use this method to determine if your originating URL or institution ID is associated with an institution, and optionally validate user access status. The properties returned can be used for branding your AI application.
Lookup Priority:
url against registered LTI context IDsinstitutionid (publicId)User Validation (optional):
When email or userid is provided, the endpoint also validates:
Status Values:
active: Institution/user is active and accessibleinactive: Institution or user account is inactivepending: User membership is pending approvalsuspended: User membership is temporarily suspendedinvalid: No institution found matching the provided criteriaThe LTI context URL to be tested. Used to find an institution by matching against registered LTI context IDs.
"https://domain.edu/7891273"
The public ID of the institution to lookup directly. Used as fallback if URL lookup fails.
"bc6efd03-9d01-43e7-bd49-c4af1c54ae3a"
The email address of the user to check membership status for.
The LXP user ID to lookup the user by (alternative to email).
"lxp_12345"
URL test completed successfully
Indicates if the institution was found via LTI context URL match
true
Name of the institution
"Acme University"
Status of the institution, user, or user-institution membership. Possible values include 'active', 'inactive', 'pending', 'suspended', 'invalid'.
active, inactive, pending, suspended, invalid, deleted "active"
AI/Digital Twin name associated with the institution
"Hugo"
Picture URL for the institution branding
"https://storage.example.com/logo.png"
Public identifier for the institution
"bc6efd03-9d01-43e7-bd49-c4af1c54ae3a"