Updates and Changes
Here's what's new in the Developer Portal
April 2025
We've been busy adding improvements to the Developer Portal over the last several weeks with a focus on readability and navigation. Listed below are some of the more impactful changes:
- A new right navigational tool called, "On This Page" is added to most pages
- The left navigation holds its place when navigating to different pages
- A new code viewer is added with syntax highlighting
- The Open API specification page is updated to handle more expressive descriptions and operation types
- Page load times are optimized
Changes have also been made to the Administrative APIs around the physical bank account field for both SOAP and REST in the following operations:
- Add Employer Bank Account
- Update Employer Bank Account
- Get Employer Bank Account
- Get Employer Bank Accounts
November 2024
On SOAP API documentation screens, field information is now in text tables instead of images for easier readability.
Implemented style changes for easier readability.
October 2024
REST APIs have new navigation controls and documentation formatting. These changes will make it easier for you to find the API information you need.
The left hand REST navigation menu was updated so that you can search for operations, expand and collapse API operation lists, and easily page through available operations.
The REST documentation was updated to clearly show field names, data types, and field descriptions.
You can now download Open API specs from any REST documentation page.
July 2024
Clicking into API documentation from an API tile will now take you to the most recent version of that API. You may manually select an older version if needed, but you will no longer have to manually select a version to see the most recent.
A new documentation page, SOAP endpoints, is now available, which contains the ASMX and SVC endpoints needed for our SOAP APIs.
The versioning page, which previously included information about how Alegeus handles API versioning as well as a developer portal change log, now just shows versioning information. A new page titled updates and changes now has the developer portal change log information.
Minor documentation corrections on multiple API operations have been made.
November 2023
Documentation updates were made for the following Administrative APIs (both REST and SOAP versions):
- Benefit Plan Rollover
- Employer Bank Account
- Employer HRA Plan
- Employer Metrics
Documentation updates were made for the following Participant APIs:
- Challenge
- CommonCodeTier
- Employer
- EmployerAccount
- EmployerTransaction
- Enrollment
- ParticipantDocument
- ParticipantHSA
- PortalInfo
- Product
- Providers
- Registration
- SecureLogon
- Transactions
- User
- UserInfo
August 2023
Documentation updates were made for the following Administrative APIs (both REST and SOAP versions):
- Employer HRA Plan
- Employer Logical Bank Account
- Employer Plan
- Employer Plan Service Category
- Employer
- TPA Default
- Transactions
Documentation updates were made for the following Participant APIs:
- DocumentManagement
- HSAInvestment
- HSAStatements
- HSATaxForms
- ParticipantAccount
- ParticipantCommunication
- ParticipantExpenses
- ParticipantReimbursements
- PayProvider
- Providers
- Repayment
July 2023
Sign-in functionality added for administrator users to view restricted content (using your WCA credentials)
An authorization guide is now available; this is currently our only restricted content.
Documentation updates were made to the following Administrative APIs (both REST and SOAP versions):
- Account
- Adjudication
- Card
- Dependent
- Documentation
- Employee
- Employer User
April 2023
The Developer Portal is launched! Initial content includes:
- Getting Started guide
- Versioning overview
- Bit Field guide
- Tools and Resources
- Best Practices
- Troubleshooting guide
- All of our existing API documentation, with extensive updates made to the following Participant APIs: Communications, ParticipantAccount, ParticipantCard, ParticipantClaimReceipts, ParticipantClaims, and Transactions.
API Changelog
April 2025
We have made changes to the Administrative APIs around the physical bank account field for both SOAP and REST in the following operations:
- Add Employer Bank Account
- Update Employer Bank Account
- Get Employer Bank Account
- Get Employer Bank Accounts
October 2024
Build Version: WCA 27.0
- The Save a Provider API operation was updated so you will be able to save participant-level providers. To support this update, two new fields were added, ParticipantId and EmployerId.
Version: 9.0 - Build Version: WCA 24.03
-
The following API operations were updated to have AccountOwner, TaxID, and AccountOwnerName fields to support Tax Identification requirements for bank accounts:
- AddEmployerBankAccount
- UpdateEmployerBankAccount
- GetEmployerBankAccount
- GetEmployerBankAccounts
- AddEmployerFundingBankAccount
- UpdateEmployerFundingBankAccount
- GetEmployerFundingBankAccount
- GetEmployerFundingBankAccounts
April 2024
Build Version: WCA 24.04
- The ParticipantSubmitClaim API operation will now allow you to successfully submit a pay provider claim from your own member portal.
March 2024
Build Version: WCA 24.03 - A list of errors updated with this release can be found in the release details document.
- Each release, we will be reviewing and updating multiple APIs to ensure the error messages you receive allow you to easily support your API implementations.
Version: 9.0 - Build Version: WCA 24.03
- "LastDayForSpendingValue" field added to the response on the GetEmployeeAccount operation.
- "CarryoverTemplate" field added to the request for the AddEmployerPlan and UpdateEmployerPlan operations, and to the response for the GetEmployerPlan and GetEmployerPlans operations.
October 2023
Build Version: WCA 23.10 - Full list of updated APIs in the 23.10 WCA release details document.
- Over the next several releases, Alegeus will be adding cache-control headers specifying the cache type (public or private) and the max-age (how many seconds the resource should be served from the cache before a new API call should be made to refresh the resource) to participant and administrative APIs. The cache-control information is included in the API operation response via the ResponseCache attribute.
Build Version: WCA 23.10 - A list of errors updated with this release can be found in the release details document.
- Each release, we will be reviewing and updating multiple APIs to ensure the error messages you receive allow you to easily support your API implementations.
Version: 2023/10 - Build Version: WCA 23.10
- Set default interest option of traditional or High-Yield via SOAP web services (AddEmployer, UpdateEmployer, GetEmployer, GetEmployers)
- Configure transaction limit type and spending limit type at the plan level (AddEmployerPlan, UpdateEmployerPlan, GetEmployerPlan, GetEmployerPlans)
- 'PlanUniqueIdentifier' field added to GetEmployerPlan and GetEmployerPlans
July 2023
Build Version: WCA 23.07 - Full list of updated APIs in the 23.07 WCA release details document.
- Over the next several releases, Alegeus will be adding cache-control headers specifying the cache type (public or private) and the max-age (how many seconds the resource should be served from the cache before a new API call should be made to refresh the resource) to participant and administrative APIs. The cache-control information is included in the API operation response via the ResponseCache attribute.
Version: 2010/04 - Build Version: WCA 23.07
- On the DepositPayroll API, the 'EmployeeDepositAmount' and 'EmployerDepositAmount' fields now allow negative values if submitting a contribution reversal transaction
Version: 1 - Build Version: WCA 23.07
- A new Branding API returns the primary, secondary, and tertiary color scheme for a brand along with its logo URL in the response.
April 2023
Version: 23 - Build Version: WCA 23.04
- Added two optional fields; 'MinUserIdLength' and 'MaxUserIdLength' to Registration API, to support improved participant guidance for username character length at registration. Impacted operations: GetAdministratorOptions(response).
March 2023
Version: 8 - Build Version: 23.3.0
- Added optional field; 'DeductibleCustomDescription' to Employer Plan API, to support dynamic plan name capabilities for LPFSA/full purpose FSA. Impacted operations: AddEmployerPlan (request), UpdateEmployerPlan (request), GetEmployerPlan (response), GetEmployerPlans (response). Changes were made to both SOAP and REST web services.
Response Codes
Response codes are updated with each WealthCare Admin (WCA) major release. Visit online resources > releases > response codes for the most complete list of error codes and descriptions.
Note: You must be logged in to WCA to access documentation in online resources.