Administrative APIs | REST

Version:
Download Open API Specification

Get Employee HSA Account Details

https://api.wealthcare.com/system/Services/Employee/Account/EmployeeHSAAccount/{tpaId}/{employerId}/{employeeId}/Details

Returns details for the HSA accounts belonging to a specified employee.

  • tpaId string Required

    A unique identifier used to identify your admin instance. This value was system generated with the admin instance was created.

  • employerId string Required

    Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

  • employeeId string Required

    Unique identifier for the employee.

  • cardProxy string

    If CardNumber is used for search criteria, this field indicates if the value in CardNumber is actually a card proxy number. 0 = CardNumber value is real card number 1 = CardNumber value is card proxy number Note: For security, the Card Proxy number is always returned in the response.

  • cardNumber string

    Provide one of the following: card number, Employee Social Security Number, or Employee ID. All are not required. If either or both of the employee identifier fields (SSN or ID) are provided in addition to the card number, the card number is used.

  • employeeSocialSecurityNumber string

    Required if this field is being used as the unique employee identifier and card number is not provided. Either this field, CardNumber or EmployeeID may be used for this purpose.

    Min Length: 0
    Max Length: 9
  • planYearListType enum<string>

    Defines what account years you wish to return. (ALL, Current, Previous, and Future)

    Possible values: ALL Current Previous Future
  • planId string

    Unique identifier that distinguishes this plan from all others you administer.

  • flexAcctId string

    A unique identifier for the employee's account, generated by WCA when the account was first set up.

  • verboseMode boolean

    If set to true, the method may return more details as to why a query did not return any records. For example, if an invalid employee social security number was sent.

  • array <object>
    • LastBalUpdateFromPP string <date-time>

      Last Balance Update Received from Product Partner Ex. 1900-01-01T00:00:00

    • AccountStatus enum<string>

      Activity status of the account. 1 = New 2 = Active 3 = Temporarily Inactive 4 = Permanently Inactive 5 = Terminated

      Possible values: All New Active TempInactive PermInactive Terminated Enrollment
    • AccountTypeCode string

      Three character abbreviation that indicates the type of account (FSA, DCA, TRN, HRA, etc.)

    • AutoDepositCalendarId string

      ID of calendar used with Auto Deposit cycle attached to the plan.

    • AutoReimbursementSetting integer <int32>

      Use this field to indicate the auto pay provider reimbursement setting on the employee account If not specified, and enrolling the participant into a plan using Auto Provider Pay, the employee will automatically inherit the default setting specified on the Benefit Plan. 0 = Pay Me (Default) 1 = Pay Provider

    • AvailableBalance number <double>

      Available Balance is the Disbursable Balance plus the Auth Hold Balance. If this account has multiple QLE Coverage Periods, this field will contain the current coverage period's balance. Note: For full-featured HRAs—HRX, HX1 …HX6—with family and individual amounts, this amount is the individual balance for the employee or dependent.

    • BalanceDue number <double>

      This field returns the aggregated total of Ineligible Card transactions by plan and year.

    • CardNumber string

      Card Proxy Number. Note: The Card Proxy number is returned in this field when either 0 or 1 is passed in the "CardProxy" field in the request. For security, the Card Proxy number is always returned in the response.

    • ClaimsCrossoverOptIn integer <int32>

      If plan is setup to allow claims cross over auto pay, this field specifies the default opt in value when assigning employees to benefit accounts. 0 = Opt Out (Default) 1 = Opt In Note: If not specified, then the employee will be assigned the plan default setting for Claims Crossover Opt-In

    • DisbPtd number <double>

      Returns the disbursements paid to date.

    • DisbursableBalance number <double>

      Disbursable Balance = Available Balance minus Auth Hold Balance. If this account has multiple QLE Coverage Periods, this field will contain the current coverage period’s balance. Note : For full-featured HRAs—HRX, HX1 …HX6—with family and individual amounts, this amount is the individual balance for the employee or dependent.

    • EligibilityDate string

      YYYYMMDD. Date upon which the employee is eligible to elect benefits.

    • EmployeeId string

      Unique identifier for the employee.

    • EmployeeSocialSecurityNumber string

      Employee Social Security Number

    • EmployerId string

      Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

    • ESignatureCode boolean

      Valid for HSA accounts only. Returns the e-signature code. True or False

    • ESignatureDate string <date-time>

      Valid for HSA accounts only. Returns the e-signature date.

    • FlexAcctId string

      A unique identifier for the employee's account, generated by WCA when the account was first set up.

    • InterestAccruedAmt number <double>

      Amount of interest accrued in current year

    • InterestRate number <double>

      Interest rate for HSA

    • NextInterestPaymentDte string

      Date of next interest payment

    • PlanId string

      Unique identifier that distinguishes this plan from all others you administer.

    • PlanYearEndDate string

      (YYYMMDD)Date after which services are not eligible for payment, unless there is an extension in the field.

    • PlanYearStartDate string

      (YYYMMDD)Date that funds are available for services.

    • PreauthBal number <double>

      Total amount of all pre-auth transactions that currently do not have a matching force post for this employee

    • ProductPartnerAccountNumber string

      HSA Account Number

    • ProductPartnerAcctStatus enum<string>

      Returns HSA account status Active = 0, Inactive = 1, Pending = 2, Dormant = 3, ClosedAccount = 4, FrozenPostNoTran = 5, FrozenPostNoDebits = 6, FrozenPostNoChecks = 7, RejectedNeedInfo = 8, RejectedNoUpdates = 9

      Possible values: Active Inactive Pending Dormant ClosedAccount FrozenPostNoTran FrozenPostNoDebits FrozenPostNoChecks RejectedNeedInfo RejectedNoUpdates SuspiciousActivity Escheated
    • ProductPartnerErrorCode string

      Product Partner Application Error Code

    • ProductPartnerId string

      ID associated with product partner

    • ProductPartnerLastUploadStatus enum<string>

      Specifies whether data was successfully copied from WealthCare Admin to the Product Partner system. 3 = Success 4 = Error re Validation; see Product Partner Error Code field. 5 = Unexpected Error 6 = Deactivated Note: This field will only populate if the account type is a Product Partner has account type.

      Possible values: None PendingCreate PendingUpdate UpToDate ValidationError UnexpectedError Deactivated InvalidAccount ApplicationApprovedManually ApplicationApproved ApplicationDeniedNoReapply ApplicationDeniedReapplyAllowed RequiresBankReview AwaitingAdditionalInformation ApplicationProcessing ApplicationSentToBank AccountReassociated DisclosuresToBeIssued DisclosureAcknowledgementRequired DisclosureAcknowledgementReceived
    • ProductPartnerOptInStatus boolean

      Indicates whether or not the employee is opted in for manual claim processing. 0 = Opt Out 1= Opt In Note: This field will only populate if the account type is a Product Partner HSA account type.

    • ProductPartnerSigCardReceivedAccountOpen boolean

      Product Partner Signature Card Received - Indicates if account is open

    • StartAutoDepositDate string

      Auto Deposit Start Date

    • TerminationDate string

      YYYYMMDD. Date upon which the employee’s account is no longer eligible for benefits. Date must be after employee Account Effective date.

    • TpaId string

      A unique identifier for your administrator instance, generated by WCA when the instance was first set up.

    • ProductPartnerName string

      Product partner name

    • HSALedgerBalance number <double>

      Balance at the start of the processing day (the balance after end of day processing is complete for the prior day). This value only applies to HSA accounts.

    • FixYeartoDateInterest number <double>

      Year to date interest adjustment

    • LastInterestPaymentAmount number <double>

      Last Interest Payment Amount

    • LastInterestPaymentDate string

      Last Interest Payment Date

    • MaintenanceFeeModel string

      Maintenance Fee Model ID

    • IncidentFeeModelId string

      Incident Fee Model ID

    • MiscFeeModelId string

      Miscellaneous Fee Model ID

    • ProductPartnerProductID string

      The product partner product ID sets the service charge model and other attributes of the account. The product partner product ID provided must be a valid product ID as configured for the admin relationship ID assigned to the employee plan.

    • InterestPlan string

      Interest Plan ID

    • TrustModelNum string

      Trust Account Model Number

    • PortfolioBalanceMarketValue number <double>

      Investment portfolio balance market value

    • ProductPartnerAccountOpenDate string

      Date of HSA account opening

    • ProductPartnerAccountCloseDate string

      Date of HSA account closure

    • ProductPartnerAccountUploadUpdateStatus string

      Product partner account upload update status

    • IDVerificationStatus enum<string>

      ID Verification Status

      Possible values: NoIdCheck IdCheckPass IdCheckFailed
    • IdvIdaFailureReason string

      ID Verification Failure Reason

    • OverdraftFeeThisPeriod number <double>

      Overdraft fees assessed this period

    • OverdraftFeesYTD number <double>

      Overdraft fees assessed year to date

    • ReturnedItemFeesThisPeriod number <double>

      Returned item fees assessed this period

    • ReturnedItemsFeesYTD number <double>

      Returned item fees assessed year to date

    • UncollectedFees number <double>

      Amount of Uncollected fees

    • NextStatementDate string

      Date next statement will be issued MMDDYYY

    • DateofDeath string

      Date of death of accountholder MMDDYYY

    • TotalContributionReporting number <double>

      Total contribution reporting

    • TotalContributionReportingEmployer number <double>

      Total employer contribution reporting

    • ContributionMadeThisYear number <double>

      Total HSA contributions made this year

    • TotalContributionMadeNextYear number <double>

      Total contributions made for future year

    • ContributionMadethisYearEmployer number <double>

      Total HSA contributions made this year by employer

    • RolloverContribution number <double>

      Total rollover contributions

    • FairMarketValue number <double>

      Fair market value of HSA

    • InvestmentFairMarketValue number <double>

      HSA Investment Fair Market Value

    • HSADateOfDeathFairMarketValue number <double>

      Fair market value of HSA at date of accountholder death

    • NormalDistribution number <double>

      Normal distribution amount year to date

    • DeathDistribution number <double>

      Total death distribution amount

    • DeathDistributionToNonSpouse number <double>

      Death distribution amount to non-spouse

    • DisabilityDistribution number <double>

      Distribution amount for disability

    • DistributionOfExcessContribution number <double>

      Distribution of excess contribution

    • DistributionOfExcessEarningsOnContributions number <double>

      Distribution of excess earnings on contributions

    • ProhibitedTransactionDistribution number <double>

      Total prohibited transaction distributions

    • TotalDistributionExcessContributionEarnings number <double>

      Total distribution excess contribution earnings

    • HsaCurrYrProcessingContr number <double>

      HSA Current Year Processing Contributions

    • HsaCurrYrProcessingContrEmpr number <double>

      HSA Current Year Processing Contributions Employer

    • PriorYearTotalContributionReporting number <double>

      Prior year total contribution reporting

    • PriorYearContributionsReportableEmployer number <double>

      Total prior year reportable contributions made by employer

    • PriorYearTotalContributionsMadeDuringPriorYear number <double>

      Prior Year Total Contributions Made During Prior Year

    • PriorYearContributionsMadeDuringPriorYearEmployer number <double>

      Prior year contributions made during prior year by Employer.

    • TotalPrevContributionMadeNextYear number <double>

      Total previous contributions made for future year

    • PriorYearRolloverContribution number <double>

      Total prior year rollover contributions

    • PriorYearFairMarketValue number <double>

      Prior year HSA fair market value

    • PriorYearInvestmentFairMarketValue number <double>

      Prior year HSA investment fair market value

    • PriorYearNormalDistribution number <double>

      Total prior year normal distributions

    • PriorYearDeathDistribution number <double>

      Total prior year death distributions

    • PriorYearDeathDistributionToNonSpouse number <double>

      Total prior year death distributions to non-spouse

    • PriorYearDisabilityDistribution number <double>

      Total prior year disability distributions

    • PriorYearProhibitedTransactionDistribution number <double>

      Total prior year prohibited transaction distribution

    • PriorYearDistributionOfEarningsOnExcessContributions number <double>

      Total prior year distribution of earnings on excess contributions

    • PriorYearTotalDistributionExcessContributionEarn number <double>

      Total distributions on excess contributions made prior year

    • PriorYearDistributionofExcessContribution number <double>

      Total prior year distribution of excess contributions

    • HsaPrevYrProcessingContr number <double>

      HSA Previous Year Processing Contributions

    • HsaPrevYrProcessingContrEmpr number <double>

      HSA Current Year Processing Contributions Employer

    • HsaAdvInitialAmt number <double>

      The total initial amount for the year/coverage period. This amount cannot exceed the IRS max contribution for the current tax year. Note: This amount does not affect the HSA cash balance.

    • HsaAdvUsedYtd number <double>

      HSA Advance used YTD Note: Including an amount in this field results in an error unless it is the first/initial HSA advance period.

    • HsaAdvRecoveredYtd number <double>

      HSA Advance recovered YTD Note: Including an amount in this field results in an error unless it is the first/initial HSA advance period.

    • HsaAdvOutstandingBal number <double>

      HSA Advance Outstanding Balance Note: Including an amount in this field results in an error unless it is the first/initial HSA advance period.

    • HsaAdvAvailBal number <double>

      HSA Advance Available Balance Note: Including an amount in this field results in an error unless it is the first/initial HSA advance period.

    • HsaAdvBeginDte string <date-time>

      Date when HSA advance is available for spending YYYYMMDD

    • HsaAdvEndDte string <date-time>

      Used to specify when employee no longer has access to HSA advance amount. WCA automatically sets this date for prior and current period if not submitted. For example, say an HSA Advance period is from 1/1/2020 through 12/31/2020. A file is submitted with: Begin Date is 3/1/2020 End Date is [blank] WCA then updates HSA Advance periods to: 1/1/2020 – 2/29/2020 and 3/1/2020 – 12/31/2020 (Dates in bold are automatically set by WCA) Overlapping HSA Advance periods are not allowed by WCA and result in an error. For example, if a period exists from 1/1 – 4/30, an error is returned if you try to submit a GH record with a begin date of 3/1. The only exception is if overlapping dates are submitted to include the last day of the calendar year ([begin date] – [12/31]). Also, since HSA Advance is tracked within calendar years, the begin and end dates submitted must be within the same calendar year.

    • HsaAdvDepositOffsetYtd number <double>

      HSA Advance Deposit Offset YTD

    • TotalDisbursableBal number <double>

      Total Disbursable Balance

    • HsaAdvAccessibilityFlag boolean

      HSA Advance Accessability flag if True then HSA Advance is accessible to the plan.

    • HsaAdvNonAccessibilityReason integer <int32>

      HSA Advance Non Accessibility Reason