USA Swimming API Program

About USA Swimming Tier Access Levels

The USA Swimming API Program allows trusted vendors to securely integrate with the SWIMS platform through a tiered system supporting everything from basic team management to real-time member verification. Built on strict security, legal compliance, and technical validation, the program ensures every integration meets USA Swimming’s standards for data protection and accuracy.

Access is organized into three tiers, each aligning vendor capabilities with appropriate data permissions, testing, and compliance oversight. This progressive model enables vendors to scale responsibly, advancing only after proving technical competency and operational readiness. Each tier adds privileges to the previous level, ranging from read-only functionality to advanced, fee-based services for real-time verification.

API Endpoints and Examples

The USA Swimming API Access Program provides structured, secure access to club rosters, member verification, registration services, NCAA integrations, event logs, and official data. All endpoints are organized by access tier and designed for approved technology partners integrating with SWIMS.

Jump to: Tier 1 – Team Management · Tier 2 – Premium · Tier 3 – Times & Verification · Tier 4 – NCAA · Member & Club Events · API User Guide · Glossary

Tier 1 - Team Management – Base Access

Read-only and foundational access for core team management: clubs, rosters, and vendor event logs.

Purpose

Returns the full roster for the specified club, including member demographic data, contact information, and all associated registrations.

Endpoint Information

HTTP Method	POST
Route	/swims/SwimsThirdParty/MemberDetails/club/
Access Tier	Tier 1
App Role Security	Third Party Base
Stored Procedure	thirdparty.GetMemberDetailsByClubId

Input Parameters

Parameter	Type	Required?	Description
vendorId	int	Yes	Retrieved from user token.
clubId	string	Yes	Club identifier.
memberId	List<string>	No	Optional member IDs.
lastModified	DateTime?	No	Filter by last modification date.

Output Model

MemberId
OldUsasId
FirstName
PreferredName
MiddleName
LastName
Suffix
MaidenName
IsUsCitizen
BirthDate
CompetitionCategory
ModifiedDatetime
ContactInformation (SwimsMemberContactInformation)
Registrations (List<SwimsMemberRegistration>)
PreviousRegistrations (List<SwimsMemberRegistration>)

Output JSON Example (click to expand)

[
{
 "memberId": "11111111111111",
 "oldUsasId": null,
 "firstName": "Test",
 "preferredName": "",
 "middleName": "",
 "lastName": "Test",
 "suffix": "",
 "maidenName": "",
 "isUsCitizen": true,
 "birthDate": "2001-01-01",
 "competitionCategory": "Female",
 "modifiedDatetime": "2025-01-01",
 "contactInformation": {
  "contactFirstName": "Test",
  "contactLastName": "Test",
  "contactEmail": "test@email.com",
  "contactPhone": "11111111111"
 },
 "registrations": [
  {
   "registrationId": 111111111111,
   "registrationDate": "2022-09-21",
   "expirationDate": "2026-12-31",
   "registrationTypeId": 1,
   "registrationType": "Premium Athlete",
   "transactionType": "New",
   "lscCode": "TD",
   "clubCode": "TDD",
   "usasFee": 0.0,
   "lscFee": 12.0,
   "isRenewal": false,
   "isAttached": true,
   "attachedDate": "2022-09-21",
   "memberGoodStandingExpirationDate": "2026-12-31"
  },
  {
   "registrationId": 10301283,
   "registrationDate": "2023-09-15",
   "expirationDate": "2026-12-31",
   "registrationTypeId": 1,
   "registrationType": "Premium Athlete",
   "transactionType": "Renew",
   "lscCode": "TD",
   "clubCode": "TDD",
   "usasFee": 0.0,
   "lscFee": 12.0,
   "isRenewal": true,
   "isAttached": true,
   "attachedDate": "2022-09-21",
   "memberGoodStandingExpirationDate": "2026-12-31"
  }
 ]
}
]

TIER 2 - Team Management – Premium Access

Write-enabled and higher-value team management operations, including offerings and bulk registrations.

Purpose

Submits club member registrations from a third-party vendor to SWIMS, including validation and registration request creation.

Endpoint Information

HTTP Method	POST
Route	/swims/SwimsThirdParty/memberRegistration/club/
App Role Security	Third Party Premium
Stored Procedures / Functions	swims.GetUsasReportPeriodForSeasonYear AddClubMemberRegistrationByOUId (C# function) thirdparty.UpdateThirdPartyRegistrationOfferingIds thirdparty.CheckThirdPartyMembers

Input Parameters

Parameter	Type	Required?	Description
vendorId	int	Yes	Retrieved from user token.
clubId	string	Yes	Club identifier.
clubMemberRegistration	List<VendorClubMemberRegistration>	Yes	List of member registrations to submit.
seasonYear	int?	No	Optional season year to apply.

VendorClubMemberRegistration

MemberId (string)
LastName (string)
FirstName (string)
BirthDate (DateTime?)
PreferredName (string)
IsUsCitizen (bool?)
ContactInfo (ClubMemberRegistrationContactInfo)
PrimaryContactInfo (ClubMemberRegistrationPrimaryContactInfo)
Memberships (List<string>)
CompetitionCategory (string)
Age (int) – API calculated

ClubMemberRegistrationContactInfo

EmailAddress (string)
PhoneNumber (string)
PhoneType (string)

ClubMemberRegistrationPrimaryContactInfo

EmailAddress (string)
PhoneNumber (string)
PhoneType (string)
FirstName (string)
LastName (string)
ContactRelationship (string)
Address (MemberRegistrationAddress)

MemberRegistrationAddress

Address1 (string)
Address2 (string)
City (string)
StateCode (string)
PostalCode (string)
CountryCode (string)

Input Validation

MemberId: may be null for new members; when provided, must be a 14-character alphanumeric string.
FirstName / LastName: required, cannot contain numbers or special characters, max 100 characters.
MiddleName / PreferredName: cannot contain numbers or special characters, max 100 characters.
BirthDate: cannot be null or 1/1/0001.
IsUsCitizen: cannot be null.
Memberships:
- Cannot be null or empty.
- Must match valid USA Swimming offerings.
- Invalid memberships for member's age are rejected.
- Duplicate offerings are not allowed.
CompetitionCategory:
- Cannot be null or empty.
- Must be FEMALE, MALE, or UNKNOWN.
- For athlete memberships, must be FEMALE or MALE.
Contact/PrimaryContact Email: must meet email standards.
Contact/PrimaryContact PhoneNumber:
- Must be valid US, Canadian or Mexican number in 1 or 52 + XXXXXXXXXX format.
Contact/PrimaryContact PhoneType: must be Mobile, Work, Home, or Other.
StateCode: cannot be null or empty; two-letter abbreviation.
PostalCode: 5-digit ZIP with optional 4-digit extension.

Output Model

Represents the third-party club registration request.

Status (string)
ClubRegistrationRequestId (int?)
RegistrationError (List<ValidateThirdPartyRegistration>)

ValidateThirdPartyRegistration

ErrorDescription (string)
Members (List<ValidateThirdPartyMember>)

ValidateThirdPartyMember

MemberId (string)
FirstName (string)
LastName (string)
ErrorValue (string)

Output JSON Example (simplified) (click to expand)

{
 "status": "Pending",
 "clubRegistrationRequestId": 12345,
 "registrationError": [
  {
   "errorDescription": "Invalid membership for age.",
   "members": [
    {
     "memberId": "11111111111111",
     "firstName": "Test",
     "lastName": "Member",
     "errorValue": "Membership PREMIUM_18U not valid for age 10."
    }
   ]
  }
 ]
}

Member Events & Club Events

These events are written to the vendor event log and can be retrieved using Get Third Party Events Within Timeframe. Use them to keep your roster, club data, and local state in sync with SWIMS.

Member Events

Member Registration & Renewal EventType: Member Registration Complete / Renewal

Generated when a member registers or renews in SWIMS via Online Member Registration (OMR).

{
  "eventSequence": 1234,
  "eventType": "Member Registration Complete",
  "clubId": "EFD6F74613444017B0DB1884AADBC117",
  "modifiedDatetime": "2022-09-13T22:52:28.882Z",
  "eventData": {
    "vendorId": "DB1884AADBC117",
    "memberId": "string"
  }
}

Recommended vendor workflow

Call GET /swims/getMemberDetails/{clubId}/?memberId={memberId}&lastModified={lastModified}.
If this is a new member, add the member and registration to your roster.
If this is a renewing member, update the existing member and registration in your roster.

Member Updated / Upgraded EventType: Member Updated

Generated when a member’s core details or their membership (e.g., upgraded registration) are updated within SWIMS.

{
  "eventSequence": 1234,
  "eventType": "Member Updated",
  "clubId": "EFD6F74613444017B0DB1884AADBC117",
  "modifiedDatetime": "2022-09-13T22:52:28.882Z",
  "eventData": {
    "memberId": "string"
  }
}

Recommended vendor workflow

Call GET /swims/getMemberDetails/{clubId}/?memberId={memberId}.
Update the member’s demographics, registration details, and status in your system to match SWIMS.

Member Merge EventType: Member Merge

Generated when two Member IDs are merged within SWIMS (duplicate resolution). The event indicates old/new member and club relationships.

{
  "eventSequence": 1234,
  "eventType": "Member Merge",
  "clubId": "1500B689DCAA42BD9484618C634DDEF0",
  "modifiedDatetime": "2022-09-13T22:52:28.882Z",
  "eventData": {
    "oldClubId": "1500B689DCAA42BD9484618C634DDEF0",
    "oldMemberId": "B71E543DBAB6BE",
    "newClubId": "6C5D210FBE0549C3A9F269E07A411E95",
    "newMemberId": "7F5564C5585A97"
  }
}

Recommended vendor workflow

Call GET /swims/getMemberDetails/{clubId}/?memberId={newMemberId} for the destination member.
If the merge is within the same club, consolidate to the newMemberId and retire the old ID in your system.
For cross-club merges, apply your business rules for moving or reconciling the member between clubs.
If you receive multiple merge events for the same member, process only the latest effective state and ignore redundant duplicates.

Member Transfers (From / To Club) EventType: Member Transfer From Club / Member Transfered To Club

A special set of events generated when a member transfers from one club to another. In SWIMS, transfers are initiated from the Member Details page via the Initiate Transfer link.

The transfer process creates two events:

Member Transfer From Club – received by the club the member is leaving.
Member Transfer To Club – received by the club the member is joining.

Vendors will only receive both events if both clubs are activated for that vendor.

{
  "eventSequence": 12,
  "eventTypeId": 4,
  "eventType": "Member Transfered To Club",
  "clubId": "1c68c4f5968e4bce96901b4f0d9d7206",
  "modifiedDatetime": "2025-11-18T19:01:40.780",
  "eventData": {
    "memberIds": ["23BF9DF1EA804E"]
  }
}

Recommended vendor workflow

Call GET /swims/getMemberDetails/{clubId}/?memberId={memberId} for each transfer event.
If the member is not found in your system, create the member under the new club.
If the member already exists in your system, update their club affiliation and apply any transfer logic your platform requires (e.g., move groups, reassign billing).
For vendors supporting both clubs, use both From and To events to keep rosters accurate and avoid stale attachments.

Member Cancels EventType: Member Cancels

Generated when a member’s registration is cancelled in SWIMS.

{
  "eventSequence": 11,
  "eventTypeId": 6,
  "eventType": "Member Cancels",
  "clubId": "EFD6F74613444017B0DB1884AADBC117",
  "modifiedDatetime": "2025-11-18T18:54:23.697",
  "eventData": {
    "memberIds": ["11111111111111"],
    "vendorRecordId": ""
  }
}

Recommended vendor workflow

Locate the affected member(s) in your system using the memberIds array.
Mark the member’s current registration as cancelled or inactive per your product’s business rules.
If you store vendorRecordId, use it to reconcile with your original transaction or order record.

Club Events

Club Activates / Deactivates Vendor EventType: Club Activates Vendor / Club Deactivates Vendor

Generated when a club selects and approves a vendor in SWIMS or removes that vendor. These events indicate changes in the vendor–club relationship.

{
  "eventSequence": "002",
  "eventType": "Club Activates Vendor",
  "clubId": "EFD6F74613444017B0DB1884AADBC117",
  "modifiedDatetime": "2022-09-13T22:52:28.882Z",
  "eventData": {
    "clubId": "string"
  }
}

Recommended vendor workflow

When activated, enable integrations and data flows for the club in your system.
When deactivated, disable integrations, stop polling/syncing, or restrict features as appropriate.
Use clubId to link the event to the correct club record locally.

Club Details Updated EventType: Club Details Updated

Generated when a club’s name or club code is updated within SWIMS.

{
  "eventSequence": 8,
  "eventTypeId": 11,
  "eventType": "Club Details Updated",
  "clubId": "EFD6F74613444017B0DB1884AADBC117",
  "modifiedDatetime": "2025-11-18T16:52:58.883",
  "eventData": {
    "clubIds": ["b5f0946c7938404092d040e509333b80"]
  }
}

Recommended vendor workflow

Refresh club details using your existing club endpoint (e.g., Get Clubs for Vendor or a club details endpoint).
Update the club’s displayed name, short code, or other dependent metadata in your UI.
If you cache club information for reporting or branding, invalidate and rebuild the cache as needed.

TIER 3 - Times and Member Verification Access

Verification-focused endpoints for membership eligibility, compliance checks, and time standard validation.

TIER 4 - NCAA Access

Restricted endpoints supporting NCAA-specific integrations for teams and rosters.

Testing with Postman

Use Postman to validate your authentication, Thumbprint configuration, and request payloads before integrating these endpoints into your application. This workflow applies to all tiers (1–4) and National Team endpoints listed above.

Tier	Postman Collection
Team Management – Base Access	Open Team Management – Base Access collection
Team Management – Premium Access	Open Team Management – Premium Access collection
Times and Member Verification Access	Open Times and Member Verification collection
NCAA Access	Open NCAA Access collection

Glossary

Key SWIMS data terms and event terminology used throughout this page. Use this glossary to align your data model and integration mapping with USA Swimming’s definitions.

SWIMS Terms

competitionCategory: Stated as male or female for the purpose of athlete swimming eligibility, competition, selection, and records. An athlete's stated competition category is referred to as "gender."
contactRelationship: Denotes the relationship between the member and their primary contact.
emailAddress: Denotes a valid email address.
isUsCitizen: Denotes whether or not the member is a U.S. citizen.
memberships: Denotes which offering instances (e.g., Coach, Official, Premium Athlete, etc.) are included in a registration.
phoneType: Denotes which type of phone has been entered (cell, home, or work).
athleteOfferingsOptIn: Denotes a club’s decision to use the Club Bulk Renewal tool for athlete renewals. When true, clubs handle all athlete renewals; when false, athletes handle their own renewals.
nonAthleteOfferingsOptIn: Denotes a club’s decision to use the Club Bulk Renewal tool for non-athlete renewals. When true, clubs handle all non-athlete renewals; when false, non-athletes handle their own renewals.
memberId: New randomly generated 14-character alphanumeric ID that is a member’s unique identifier.
oldUsasId: Legacy USA Swimming 14-character ID derived from first name, middle initial, last name, and birthdate.
firstName: The first name of a member as listed in SWIMS.
preferredName: The name a member would prefer to be called as listed in SWIMS.
middleName: The middle name of a member as listed in SWIMS.
lastName: The last name of a member as listed in SWIMS.
suffix: Follows the member’s full name and provides additional information such as generational designations (Sr., Jr.) or education/honors (Esq., Ph.D.).
maidenName: The maiden name of a member as listed in SWIMS.
birthDate: The date of birth of a member as listed in SWIMS.
contactInformation / primaryContactInfo: A member’s primary contact (Guardian / Emergency Contact depending on age) listed in SWIMS.
contactFirstName: First name of a member’s primary contact as listed in SWIMS.
contactLastName: Last name of a member’s primary contact as listed in SWIMS.
contactEmail: Email address of a member’s primary contact as listed in SWIMS.
contactPhone: Phone number of a member’s primary contact as listed in SWIMS.
registrationDate: The date of a member registration.
expirationDate: The date that a member’s registration expires. Inclusive — the member is in good standing through this date.
offeringId: The ID of the registration type.
registrationId: Internal primary key (PK) reference to the registration.
registrationType: Descriptor for the registration type.
registrationTypeId: Reference to the type of registration that occurred (Coach, Premium Athlete, Flex, etc.).
transactionType: Registration, Upgrade, or Cancel.
usasFee: USA Swimming’s membership fee. For upgrades, this shows the delta between the original USAS fee and the upgraded membership USAS fee.
lscFee: The member’s Local Swimming Committee membership fee. For upgrades, this shows the delta between the original LSC fee and the upgraded membership LSC fee.
lscCode: Alphabetic code that identifies the LSC (e.g., CO, AZ, AD).
isRenewal: Indicates whether the registration is for an existing member (renewal) or a new member.
isAttached: Indicates whether the member is attached to a club at that moment in time. There are a number of days between when a member leaves one club and joins another.
attachedDate: The date the member attaches to a club and officially becomes a member of that club.
memberGoodStandingExpirationDate: The date that a member is no longer “in good standing.” Inclusive — the member is in good standing through this date.
In Good Standing: Used to describe that all member requirements for the registration type are met. For example, an 18+ athlete must complete Athlete Protection Training to be a “member in good standing.”
clubId: Alphanumeric ID that is a club’s unique identifier.
clubCode: A globally unique identifier (GUID) that represents the club.
clubName: The name of the club.
vendorId: Alphanumeric ID that is a vendor’s unique identifier.
vendorRecordId: A value that vendors send to USA Swimming so they can better track member registrations.
Upgrade: When a member upgrades their membership, the initial membership expires (expiration date set to yesterday). A new registration record is created with a registration date of today and an expiration date at the end of the season.

Event Terms

eventSequence: A calculated value that is distinct by vendor to define the sequence in which events occur.
eventTypeId: Internal primary key (PK) reference to the event type.
eventType: The name of the event that occurred (e.g., Member Updated).
eventData: A stringified JSON object that contains different data depending on the event.

Application & Onboarding

API access is structured into three defined tiers that align each vendor’s technical capability with appropriate levels of data access, testing, and compliance oversight. This tiered model ensures that integrations scale responsibly, allowing vendors to progress only after demonstrating technical competency, adherence to data protection standards, and operational readiness.

Each tier grants a distinct set of permissions and responsibilities, from basic read-only functionality to advanced, fee-based services enabling real-time member verification and results submission. Each higher tier includes the privileges of the preceding level, ensuring a controlled and progressive path toward deeper system integration.

Application Submission

The USA Swimming API Access Program provides access to organizations and individuals who serve our members, clubs, coaches, and athletes. API Access is granted through an application and onboarding process.

Ready to Apply? Download the API Access Program Application ?

Need help?

For questions about onboarding, access tiers, or specific endpoints, contact Mitch Gold - mgold@usaswimming.org or submit a ticket through the USA Swimming Third-Party Vendor API portal.

HTTP Method	GET
Route	/swims/SwimsThirdParty/VendorClubs/vendor
Access Tier	Tier 1
App Role Security	Third Party Base
Stored Procedure	thirdparty.GetClubsForVendor

HTTP Method	GET
Route	/swims/SwimsThirdParty/RegistrationLink/club/
Access Tier	Tier 1
App Role Security	Third Party Base
Stored Procedure	thirdparty.GetOMRLinkByOUId

HTTP Method	GET
Route	swims/SwimsThirdParty/ClubBulkRenewalOptIn/club/
Access Tier	Tier 1
App Role Security	Third Party Base
Stored Procedure	swims.GetClubBulkRenewalOptInByOUId

HTTP Method	GET
Route	/swims/SwimsThirdParty/EventsWithinDateTime/from/
Access Tier	Tier 1
App Role Security	Third Party Base
Stored Procedure	swims.GetVendorEventLogsByDatetimeRange

Parameter	Type	Required?	Description
vendorId	int	Yes	Retrieved from user token.
fromDateTime	DateTime	Yes	Start of the event time window.
toDateTime	DateTime?	No	End of the event time window. If null, defaults to now.
clubId	string?	No	Optional club filter.

HTTP Method	GET
Route	/swims/SwimsThirdParty/Offering/club/
App Role Security	Third Party Premium
Stored Procedure	thirdparty.GetClubOfferingsByOUID

Parameter	Type	Required?	Description
vendorId	int	Yes	Retrieved from user token.
clubRegistrationRequestId	int	Yes	Registration request identifier.

HTTP Method	GET
Route	/swims/SwimsThirdParty/TimeVerification
App Role Security	Third Party Time Verification
Stored Procedure	thirdparty.GetMemberVerification

HTTP Method	GET
Route	/swims/SwimsThirdParty/NcaaTeams
App Role Security	Third Party NCAA
Stored Procedure	thirdparty.GetNcaaTeams

HTTP Method	GET
Route	/swims/SwimsThirdParty/NcaaMemberDetails/team/
App Role Security	Third Party NCAA
Stored Procedure	thirdparty.GetNcaaPersonDetailsByOUId

Parameter	Type	Required?	Description
vendorId	int	Yes	Retrieved from user token.
collegeId	string	Yes	College identifier.

USA Swimming

API Program

About USA Swimming Tier Access Levels

Tier 1: Team Management Base

Tier 2: Team Management Premium

Tier 3: Times and Member Verification Access

API Endpoints and Examples

Tier 1 - Team Management – Base Access

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

Output Model

TIER 2 - Team Management – Premium Access

Purpose

Endpoint Information

Input Parameters

Output Model

SwimsEventData

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

VendorClubMemberRegistration

ClubMemberRegistrationContactInfo

ClubMemberRegistrationPrimaryContactInfo

MemberRegistrationAddress

Input Validation

Output Model

ValidateThirdPartyRegistration

ValidateThirdPartyMember

Purpose

Endpoint Information

Input Parameters

Output Model

Member Events & Club Events

TIER 3 - Times and Member Verification Access

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

Output Model

TIER 4 - NCAA Access

Purpose

Endpoint Information

Input Parameters

Output Model

Purpose

Endpoint Information

Input Parameters

Output Model

Testing with Postman

Glossary

SWIMS Terms

Event Terms

Application & Onboarding

Application Submission

Onboarding and Authentication

API Access Documentation