Skip to main content
Version: 2.0.0

Get Balance

Get Balance

The Credit/Wallet Balance endpoint allows you to retrieve the available credit and wallet (BanditCash) balances for your account. Use this endpoint to view your current account balances across the service types supported by TaxBandits. The response provides the available credit balance for each supported service type, along with your BanditCash wallet balance.

GET Utility/GetBalance 

Response Body

FieldTypeDescription
AvailableCreditBalanceObjectReturns the available credit balance for your account across all available service types supported by Taxbandits.
Form1099W2SeriesObjectReturns the available credit balance for the 1099/W-2 form series service types.
FederalEfileNumberAvailable credit balance for the 1099/W-2 form series Federal E-filing service.
StateEfileNumberAvailable credit balance for the 1099/W-2 form series State E-filing service.
OnlineAccessNumberAvailable credit balance for the 1099/W-2 form series online access service.
PostalMailingNumberAvailable credit balance for the 1099/W-2 form series domestic postal mailing service.
ForeignPostalMailingNumberAvailable credit balance for the 1099/W-2 form series foreign postal mailing service.
AdditionalAttachmentsMailingNumberAvailable credit balance for the 1099/W-2 form series additional attachment service.
Form94xSeriesObjectReturns the available credit balance for 94x form series service types.
Form94xNumberAvailable credit balance for the Forms 941, 940, 943, 944, 945, 941-x Federal E-filing service.
Form8974NumberAvailable credit balance for the Form 8974 Federal E-filing service.
Form941ScheduleRNumberAvailable credit balance for the Form 941 Schedule R Federal E-filing service.
Form940ScheduleRNumberAvailable credit balance for the Form 940 Schedule R Federal E-filing service.
FormACASeriesObjectReturns the available credit balance for ACA form series service types.
ACAFederalEfileNumberAvailable credit balance for the ACA form series Federal E-filing service.
ACAStateEfileNumberAvailable credit balance for the ACA form series State E-filing service.
ACAPostalMailingNumberAvailable credit balance for the ACA form series Postal mailing service.
ExtensionFormsObjectReturns the available credit balance for Extension form series service types.
Form8809EfileNumberAvailable credit balance for the Form 8809 E-filing service.
Form15397NumberAvailable credit balance for the Form 15397 E-filing service.
Form7004EfileNumberAvailable credit balance for the Form 7004 E-filing service.
Form4868EfileNumberAvailable credit balance for the Form 4868 E-filing service.
FormW9W8BENSeriesObjectReturns the available credit balance for withholding form series, 1099 transactions, and TIN matching service types.
FormW9W8NumberAvailable credit balance for the Form W-9/W-8 form series.
Transactions1099NumberAvailable credit balance for the 1099 transactions.
TINMatchingNumberAvailable credit balance for the TIN matching service.
PIFNumberAvailable credit balance for the PIF (Payer Information).
PayrollFormsObjectReturns the available credit balance for payroll form series including State withholding and Unemployment Insurance and new hire reporting service types.
StateWithholdingAndUINumberAvailable credit balance for the State withholding or Unemployment Insurance reporting.
NewHireReportNumberAvailable credit balance for the new hire reporting.
AvailableBanditCashBalanceNumberAvailable Bandit cash wallet balance amount in your account
Errorsobject[]Shows detailed error information
IdstringReturns the validation error ID
NamestringName of the validation error
MessagestringDescription of the validation error
Response JSON
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
Response: 200
{
"AvailableCreditBalance": {
"Form1099W2Series": {
"FederalEfile": 1293,
"StateEfile": 694,
"OnlineAccess": 593,
"PostalMailing": 547,
"ForeignPostalMailing": 499,
"AdditionalAttachmentsMailing": 0
},
"Form94xSeries": {
"Form94x": 498,
"Form8974": 500,
"Form941ScheduleR": 500,
"Form940ScheduleR": 500
},
"FormACASeries": {
"ACAFederalEfile": 500,
"ACAStateEfile": 0,
"ACAPostalMailing": 0
},
"ExtensionForms": {
"Form8809Efile": 0,
"Form15397": 0,
"Form7004Efile": 0,
"Form4868Efile": 0
},
"FormW9W8BENSeries": {
"FormW9W8": 490,
"Transactions1099": 1000,
"TINMatching": 448,
"PIF": 500
},
"PayrollForms": {
"StateWithholdingAndUI": 0,
"NewHireReport": 44
}
},
"AvailableBanditCashBalance": null,
"Errors": null
}