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
| Field | Type | Description |
|---|---|---|
| AvailableCreditBalance | Object | Returns the available credit balance for your account across all available service types supported by Taxbandits. |
| Form1099W2Series | Object | Returns the available credit balance for the 1099/W-2 form series service types. |
| FederalEfile | Number | Available credit balance for the 1099/W-2 form series Federal E-filing service. |
| StateEfile | Number | Available credit balance for the 1099/W-2 form series State E-filing service. |
| OnlineAccess | Number | Available credit balance for the 1099/W-2 form series online access service. |
| PostalMailing | Number | Available credit balance for the 1099/W-2 form series domestic postal mailing service. |
| ForeignPostalMailing | Number | Available credit balance for the 1099/W-2 form series foreign postal mailing service. |
| AdditionalAttachmentsMailing | Number | Available credit balance for the 1099/W-2 form series additional attachment service. |
| Form94xSeries | Object | Returns the available credit balance for 94x form series service types. |
| Form94x | Number | Available credit balance for the Forms 941, 940, 943, 944, 945, 941-x Federal E-filing service. |
| Form8974 | Number | Available credit balance for the Form 8974 Federal E-filing service. |
| Form941ScheduleR | Number | Available credit balance for the Form 941 Schedule R Federal E-filing service. |
| Form940ScheduleR | Number | Available credit balance for the Form 940 Schedule R Federal E-filing service. |
| FormACASeries | Object | Returns the available credit balance for ACA form series service types. |
| ACAFederalEfile | Number | Available credit balance for the ACA form series Federal E-filing service. |
| ACAStateEfile | Number | Available credit balance for the ACA form series State E-filing service. |
| ACAPostalMailing | Number | Available credit balance for the ACA form series Postal mailing service. |
| ExtensionForms | Object | Returns the available credit balance for Extension form series service types. |
| Form8809Efile | Number | Available credit balance for the Form 8809 E-filing service. |
| Form15397 | Number | Available credit balance for the Form 15397 E-filing service. |
| Form7004Efile | Number | Available credit balance for the Form 7004 E-filing service. |
| Form4868Efile | Number | Available credit balance for the Form 4868 E-filing service. |
| FormW9W8BENSeries | Object | Returns the available credit balance for withholding form series, 1099 transactions, and TIN matching service types. |
| FormW9W8 | Number | Available credit balance for the Form W-9/W-8 form series. |
| Transactions1099 | Number | Available credit balance for the 1099 transactions. |
| TINMatching | Number | Available credit balance for the TIN matching service. |
| PIF | Number | Available credit balance for the PIF (Payer Information). |
| PayrollForms | Object | Returns the available credit balance for payroll form series including State withholding and Unemployment Insurance and new hire reporting service types. |
| StateWithholdingAndUI | Number | Available credit balance for the State withholding or Unemployment Insurance reporting. |
| NewHireReport | Number | Available credit balance for the new hire reporting. |
| AvailableBanditCashBalance | Number | Available Bandit cash wallet balance amount in your account |
| Errors | object[] | Shows detailed error information |
| Id | string | Returns the validation error ID |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Payload
Response JSON
| Response | Description | Action |
|---|---|---|
| 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
}