Skip to content
Help Center
Help Center

AAU API User Guide for Third-Party Vendors

Updated 4 min read

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.

  1. 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.

  1. 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.

Still need help?

Our support team answers every request — usually within one business day.