The USA Swimming API uses OAuth client credentials flow for authentication. Vendors must obtain an access token from the USA Swimming identity platform and include the token in the Authorization header for all protected API requests.

Obtaining an Access Token

To obtain an access token, submit a POST request using your assigned username and password credentials.

Payload Body Example

{
  "username": "test",
  "password": "1234"
}

Example Response

{
  "access_token": "eyJhbGciOiJSUzI1..."
}

Access tokens expire after approximately 24 hours. Applications should request a new token shortly before the current token expires to avoid authentication interruptions.

Use the appropriate API environment for testing or production integrations.

Note: The Stage environment is intended for testing and validation purposes only and may not reflect live production data.

Purpose

Returns third-party event logs for a vendor within a specified date/time range, optionally filtered by club.

Endpoint Information

Input Parameters

Output Model

• EventSequence (int)
• EventTypeId (int)
• EventType (string)
• ClubId (string)
• ModifiedDatetime (DateTime)
• EventData (SwimsEventData)

SwimsEventData

• VendorRecordId (string)
• MemberIds (List<string>)
• ClubIds (List<string>)
• OldClubId (string)
• OldMemberId (string)
• NewClubId (string)
• NewMemberId (string)

[
 {
  "eventSequence": 1,
  "eventTypeId": 7,
  "eventType": "Member Details Updated",
  "clubId": "7BA19941A1254489BD6F4B692A4FD0D2",
  "modifiedDatetime": "2025-10-01",
  "eventData": {
    "memberIds": [
      "11111111111111"
    ]
  }
 }
]

Purpose

Returns the OMR offerings for a given club, optionally filtered by season year.

Endpoint Information

Input Parameters

Output Model

• OfferingId (int)
• OfferingTypeId (int?)
• OfferingName (string)
• OfferingDescription (string)
• AgeStart (int)
• AgeEnd (int)

[
 {
  "offeringId": 1,
  "offeringTypeId": 10,
  "offeringName": "Premium Athlete",
  "offeringDescription": "Full-season athlete membership",
  "ageStart": 13,
  "ageEnd": 18
 }
]

Purpose

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

Endpoint Information

Input Parameters

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

Input Validation

• MemberId may be null for new members; when provided, must be a 14-character alphanumeric string.
• FirstName / LastName are required, cannot contain numbers or special characters, and have a max length of 100 characters.
• BirthDate and IsUsCitizen cannot be null.
• Memberships cannot be null or empty, must match valid USA Swimming offerings, and cannot contain duplicates.
• CompetitionCategory must be FEMALE, MALE, or UNKNOWN.
• Contact and Primary Contact email and phone values must meet validation standards.
• StateCode and PostalCode must meet required formatting standards.

Output Model

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

{
 "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."
    }
   ]
  }
 ]
}

Purpose

Returns the status of a previously submitted third-party registration request.

Endpoint Information

Input Parameters

Output Model

• Status (string)

Status values:

• ClubRegistrationRequestId Not Found
• ClubRegistrationRequestId Payment Pending
• ClubRegistrationRequestId Processed
• ClubRegistrationRequestId Pending

{
 "status": "ClubRegistrationRequestId Processed"
}

Webhooks provide real-time notifications from SWIMS to registered webhook endpoints when membership or club data changes occur.

Membership Webhooks

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

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

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

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

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

Club Webhooks

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

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

Purpose

Verifies a member's registration and eligibility status for a given club and LSC, optionally for a specified meet start date.

Endpoint Information

Input Parameters

Output Model

• MemberId (string)
• MemberFound (bool)
• MemberHasActiveRegistrationToClub (bool?)
• MemberHasActiveRegistrationToLSC (bool?)
• MemberHasActiveRegistration (bool?)
• MemberHasActiveAthleteRegistration (bool?)
• MemberHasActiveFlexRegistration (bool?)
• MemberHasActiveSeasonalRegistration (bool?)
• IsAPTInGoodStanding (bool?)
• IsMemberIneligible (bool?)
• IsAthlete18YearsOrOlder (bool?)

[
 {
  "memberId": "11111111111111",
  "memberFound": true,
  "memberHasActiveRegistrationToClub": true,
  "memberHasActiveRegistrationToLSC": true,
  "memberHasActiveRegistration": true,
  "memberHasActiveAthleteRegistration": true,
  "memberHasActiveFlexRegistration": false,
  "memberHasActiveSeasonalRegistration": false,
  "isAPTInGoodStanding": true,
  "isMemberIneligible": false,
  "isAthlete18YearsOrOlder": true
 }
]

Purpose

Verifies whether a member has a valid time for a given event within a qualifying date range.

Endpoint Information

Input Parameters

Output Model

• IsTimeValid (bool)

{
 "isTimeValid": true
}

Purpose

Returns a list of NCAA teams available to the vendor.

Endpoint Information

Input Parameters

Output Model

• Division (string)
• Conference (string)
• CollegeCode (string)
• CollegeName (string)
• CollegeId (string)

[
 {
  "division": "Division I",
  "conference": "SEC",
  "collegeCode": "ABC",
  "collegeName": "Example University",
  "collegeId": "11111111-1111-1111-1111-111111111111"
 }
]

Purpose

Returns the NCAA team roster for the specified college.

Endpoint Information

Input Parameters

Output Model

• MemberId (string)
• LastName (string)
• FirstName (string)
• PreferredName (string)
• BirthDate (string)
• CompetitionGenderTypeCode (string)
• EligibilityYear (string)

[
 {
  "memberId": "11111111111111",
  "lastName": "Doe",
  "firstName": "Jane",
  "preferredName": "Janey",
  "birthDate": "2003-05-01",
  "competitionGenderTypeCode": "F",
  "eligibilityYear": "Sophomore"
 }
]

Use Postman to validate authentication, request payloads, and API responses before integrating USA Swimming endpoints into production systems.

Collections by Access Tier

Download the appropriate Postman collection to test authentication, endpoint access, and request payloads for your assigned API tier.

Importing Collections into Postman

Note: Access to API collections and endpoints is controlled by assigned API roles and approved access tiers.

Reference definitions for common SWIMS data fields and event terminology used throughout this API documentation.

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.