AAU API User Guide for Third-Party Vendors
This guide provides an overview of the Uventex Sports Hub API for AAU, including how to authenticate using API keys and how to interact with each available endpoint.
The API Key request link: Request API key
Please note, that you must ask AAU to pre-authorize your account before requesting the API key.
- Authentication & API Keys
Uventex APIs use API keys to authenticate requests. Two types of keys may be provided:
Public API Key
Read-only access
Used for non-sensitive membership lookups
Passed in the header as:
X-Uventex-Public-Api-Key: YOUR_PUBLIC_KEYSecret API Key
Extended or sensitive data access
Must be stored securely
Passed in the header:
X-Uventex-Private-Api-Key: YOUR_SECRET_KEYGeneral Rules
Always use HTTPS.
Store keys in encrypted environment variables.
Do not expose Secret Keys in frontend code.
Requests without a key or with an invalid key will return 403 Unauthorized.
- API Endpoints Overview
Available endpoints:
Verify Club Membership
Get Club Roster
Get Team Roster
Get List of All Teams in a Club
Verify Individual Membership
Verify Event License
Each section below includes details, parameters, responses, and cURL examples.
2.1 Verify Club Membership
Endpoint:
GET /membership/club/verify
Description:
Checks whether a club membership is valid using the Club Membership ID and Primary Contact Membership ID.
Parameters
Name
Type
Description
membershipId
string
Club Membership ID (6–8 uppercase letters)
primaryContactId
string
Primary Contact ID (8–9 uppercase letters)
Response Codes
Code
Description
200
Successfully verified
400
Incorrect or inactive membership
403
Invalid API key
404
Club Membership not found
500
Internal server error
Example Request
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/club/verify?membershipId=U1234567&primaryContactId=U1234567'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
2.2 Get Club Roster
Endpoint:
GET /membership/club/roster
Description:
Returns club details and a complete list of all associated members.
Parameters
Same as the membership verification endpoint:
Name
Type
Description
membershipId
string
AAU Club ID
primaryContactId
string
Primary Contact ID
Response Codes
Code
Description
200
Roster retrieved
400
Invalid data or inactive membership
403
Invalid API key
404
Club Membership not found
500
Internal error
Example Request
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/club/roster?membershipId=U1234567&primaryContactId=U1234567'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
2.3 Get Team Roster
Endpoint:
GET /membership/team/roster
Description:
Returns the roster for a specific team. You may search by Team ID or team name.
Parameters
Name
Type
Description
membershipId
string
Club Membership ID
primaryContactId
string
Primary Contact ID
teamId
string
Team UID (10 uppercase letters) or team name
Response Codes
Code
Description
200
Team roster retrieved
400
Invalid or inactive membership
403
Invalid API key
404
Team or Club not found
500
Internal error
Example Requests
By Team ID:
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/team/roster?membershipId=U1234567&primaryContactId=U1234567&teamId=C123456789'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'By Team Name:
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/team/roster?membershipId=U1234567&primaryContactId=U1234567&Super%20Team'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
2.4 Get List of All Teams in a Club
Endpoint:
GET /membership/team
Description:
Retrieves all teams associated with a club.
Parameters
Name
Type
Description
membershipId
string
Club ID
primaryContactId
string
Primary Contact ID
Response Codes
Code
Description
200
Teams list retrieved
400
Invalid/inactive membership
403
Invalid API key
404
Club or teams not found
500
Internal server error
Example Request
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/team?membershipId=U1234567&primaryContactId=U1234567'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
2.5 Verify Individual Membership
Endpoint:
GET /membership/individual/verify
Description:
Verifies an individual AAU membership using either:
Option A — With Membership ID:
- membershipId + (lastName or zipCode or birthDate)
Option B — Without Membership ID:
- firstName + lastName + zipCode + birthDate
Parameters
Name
Type
Description
membershipId
string
Individual Membership ID
lastName
string
Member last name
firstName
string
Member first name
zipCode
string
Member ZIP
birthDate
string (YYYY-MM-DD)
Member birth date
Response Codes
Code
Description
200
Valid membership (full or public view based on key type)
400
Invalid/inactive membership
403
Invalid API key
404
Individual not found
500
Internal server error
Examples
With Membership ID:
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/individual/verify?membershipId=U1234567&birthDate=2000-01-01'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'Without Membership ID:
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/individual/verify?lastName=Lewis&firstName=Mark&zipCode=11111&birthDate=2000-01-01'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
2.6 Verify Event License
Endpoint:
GET /membership/event-license/verify
Description:
Validates an AAU event license for a given year.
Parameters
Name
Type
Description
licenseId
string
Event License ID (10 uppercase letters)
year
integer
License year (YYYY)
Response Codes
Code
Description
200
License valid
400
Incorrect input
403
Invalid API key
404
License not found
500
Internal error
Example Request
curl -X 'GET'
'https://sportshub-aau-api.uventex.com/membership/event-license/verify?licenseId=E123456789&year=2026'
-H 'accept: application/json'
-H 'X-Uventex-Public-Api-Key: YOUR_KEY'
3. Error Handling & Troubleshooting
Common Error Responses
Code
Meaning
400
Invalid input (wrong ID format, expired membership, missing fields)
403
API key invalid, expired, or missing
404
Not found (membership/team/license does not exist)
500
Server error
Tips
Check for typos in Membership IDs (case sensitive).
Ensure the correct API key is used (Public or Secret).
Validate date format: YYYY-MM-DD.
URL-encode team names containing spaces or special characters.
Was this article helpful?
Thanks for your feedback!