Version: 1.7.3

Update

Use this endpoint to update the information on existing PA W-3 forms that are already created for a specific employer (payer).

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/PAWH/Update

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateWHRecords	Object[]	Object to create Form W-3
SequenceId	String	A unique number given by an inbound application to identify failed records. Size Range: 1-10
ReturnHeader	Object	Identifies the supporting details of Form W-3
Qtr	String	The quarter for which Form W-3 needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
TaxYr	String	The tax year for which Form W-3 needs to be filed. Allowed values "2025"
Business	Object	The details of the business you're filing for.
BusinessNm	String	Name of the business. Size Range: 1-75
PayerRef	string	Optional A unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: 1-50
TradeNm	String	Optional Name under which the business operates. Size Range: 1-75
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	String	When IsEIN is true, use Employer Identification Number (EIN). Size Range: 9-11
Email	String	Email address of the business. Size Range: 1-100
IsForeign	Boolean	When true, identifies the business as having a foreign address.
USAddress	Object	If IsForeign is false, pass the US address of the business.
Address1	String	Employer/Payer's US address (street address or post office box). Size Range: 1-46
Address2	String	Optional Employer/Payer's suite or apartment. Size Range: 1-46
City	String	Employer/Payer's city. Size Range: 1-50
State	String	Employer/Payer's state. Size Range: 2 Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	String	Employer/Payer's zip code. Size Range: 5-10
ForeignAddress	Object	If IsForeign is true, pass the foreign address of the business.
Address1	String	Employer/Payer's foreign address (street address or post office box). Size Range: 1-50
Address2	String	Optional Employer/Payer's suite or apartment. Size Range: 1-50
City	String	Employer/Payer's city. Size Range: 1-50
ProvinceOrStateNm	String	Employer/Payer's province or state name. Size Range: 1-50
Country	String	Employer/Payer's country. Size Range: 2 Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
PostalCd	String	Employer/Payer's postal code. Size Range: 1-16
ReturnData	Object	Identifies the Form W-3
FormW3	Object	Pennsylvania withholding tax returns.
WHIdNum	String	Pennsylvania withholding file number. Size Range: 8 or 11
DepositSchedule	string	The filing frequency of Form W-3 Allowed values "QUARTERLY", "MONTHLY", "SEMI_MONTHLY", "SEMI_WEEKLY"
TotPayrollAmt	Number	Total pennsylvania taxable wages paid for the quarter. Size Range: 0-999999999.99
TaxWH	Number	Pennsylvania income tax withheld from all sources for the filing period Size Range: 0-99999999.99
TaxPaid	Number	Pennsylvania income tax paid from all sources for the filing period Size Range: 0-99999999.99
Overpayment	Number	Overpayment amount. Size Range: 0-999999999.99
BalanceDue	Number	Balance due amount. Size Range: 0-999999999.99
MonthlyWHDeposit	Object	Identifies details of monthly tax withheld deposits.
Month1WHAmt	Number	Total Pennsylvania income tax withheld for the month 1. Size Range: 0-999999999.99
Month2WHAmt	Number	Total Pennsylvania income tax withheld for the month 2. Size Range: 0-999999999.99
Month3WHAmt	Number	Total Pennsylvania income tax withheld for the month 3. Size Range: 0-999999999.99
SemiMonthlyWHDeposit	Object	Identifies details of semi-monthly tax withheld deposits.
Month1FHWHAmt	Number	Total Pennsylvania income tax withheld for the first half of Month 1. Size Range: 0-999999999.99
Month1SHWHAmt	Number	Total Pennsylvania income tax withheld for the second half of Month 1. Size Range: 0-999999999.99
Month2FHWHAmt	Number	Total Pennsylvania income tax withheld for the first half of Month 2. Size Range: 0-999999999.99
Month2SHWHAmt	Number	Total Pennsylvania income tax withheld for the second half of Month 2. Size Range: 0-999999999.99
Month3FHWHAmt	Number	Total Pennsylvania income tax withheld for the first half of Month 3. Size Range: 0-999999999.99
Month3SHWHAmt	Number	Total Pennsylvania income tax withheld for the second half of Month 3. Size Range: 0-999999999.99
SemiWeeklyWHDeposit	Object	Identifies details of semi-weekly tax withheld deposits.
Period1	Number	Total Pennsylvania income tax withheld for Period 1 of the semi-weekly deposit. Size Range: 0-999999999.99
Period2	Number	Total Pennsylvania income tax withheld for Period 2 of the semi-weekly deposit. Size Range: 0-999999999.99
Period3	Number	Total Pennsylvania income tax withheld for Period 3 of the semi-weekly deposit. Size Range: 0-999999999.99
Period4	Number	Total Pennsylvania income tax withheld for Period 4 of the semi-weekly deposit. Size Range: 0-999999999.99
Period5	Number	Total Pennsylvania income tax withheld for Period 5 of the semi-weekly deposit. Size Range: 0-999999999.99
Period6	Number	Total Pennsylvania income tax withheld for Period 6 of the semi-weekly deposit. Size Range: 0-999999999.99
Period7	Number	Total Pennsylvania income tax withheld for Period 7 of the semi-weekly deposit. Size Range: 0-999999999.99
Period8	Number	Total Pennsylvania income tax withheld for Period 8 of the semi-weekly deposit. Size Range: 0-999999999.99
Period9	Number	Total Pennsylvania income tax withheld for Period 9 of the semi-weekly deposit. Size Range: 0-999999999.99
Period10	Number	Total Pennsylvania income tax withheld for Period 10 of the semi-weekly deposit. Size Range: 0-999999999.99
Period11	Number	Total Pennsylvania income tax withheld for Period 11 of the semi-weekly deposit. Size Range: 0-999999999.99
Period12	Number	Total Pennsylvania income tax withheld for Period 12 of the semi-weekly deposit. Size Range: 0-999999999.99
Period13	Number	Total Pennsylvania income tax withheld for Period 13 of the semi-weekly deposit. Size Range: 0-999999999.99
Period14	Number	Total Pennsylvania income tax withheld for Period 14 of the semi-weekly deposit. Size Range: 0-999999999.99
Period15	Number	Total Pennsylvania income tax withheld for Period 15 of the semi-weekly deposit. Size Range: 0-999999999.99
Period16	Number	Total Pennsylvania income tax withheld for Period 16 of the semi-weekly deposit. Size Range: 0-999999999.99
Period17	Number	Total Pennsylvania income tax withheld for Period 17 of the semi-weekly deposit. Size Range: 0-999999999.99
Period18	Number	Total Pennsylvania income tax withheld for Period 18 of the semi-weekly deposit. Size Range: 0-999999999.99
Period19	Number	Total Pennsylvania income tax withheld for Period 19 of the semi-weekly deposit. Size Range: 0-999999999.99
Period20	Number	Total Pennsylvania income tax withheld for Period 20 of the semi-weekly deposit. Size Range: 0-999999999.99
Period21	Number	Total Pennsylvania income tax withheld for Period 21 of the semi-weekly deposit. Size Range: 0-999999999.99
Period22	Number	Total Pennsylvania income tax withheld for Period 22 of the semi-weekly deposit. Size Range: 0-999999999.99
Period23	Number	Total Pennsylvania income tax withheld for Period 23 of the semi-weekly deposit. Size Range: 0-999999999.99
Period24	Number	Total Pennsylvania income tax withheld for Period 24 of the semi-weekly deposit. Size Range: 0-999999999.99
Period25	Number	Total Pennsylvania income tax withheld for Period 25 of the semi-weekly deposit. Size Range: 0-999999999.99
Period26	Number	Total Pennsylvania income tax withheld for Period 26 of the semi-weekly deposit. Size Range: 0-999999999.99
Period27	Number	Total Pennsylvania income tax withheld for Period 27 of the semi-weekly deposit. Size Range: 0-999999999.99
TotQtrTaxLiabAmt	Number	Total tax required to be withheld for all the months of the quarter. Size Range: 0-99999999.99

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission
SuccessRecords	object[]	It will show the detailed information about the success status of Form W-3 Records
SequenceId	string	A unique number given by an inbound application to identify particular records.
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of the payer
RecordId	Guid	A unique identifier generated by TaxBandits when a W-3 return is created
FormType	string	Denotes the type of withholding form W-3.
Status	string	Returns the record status of return.
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return
Errors	object[]	Shows error information of state returns of Form W-3
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
ErrorRecords	object[]	It will show the detailed information about the error status of Form WH-1001 Records.
SequenceId	string	A unique number given by an inbound application to identify particular records. The Sequence ID will be returned in the Response for your reference.
RecordId	Guid	Unique identifier of a record
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

Request JSON

{ 
    "SubmissionId": "019db3c1-8275-71c4-8899-4f3ec8dff392",
    "StateWHRecords": [
        {
            "SequenceId": "001",
            "RecordId": "019db3c1-83bb-741d-a785-2261c5fd7fb1",
            "ReturnHeader": {
                "Qtr": "Q2",
                "TaxYr": "2025",
                "Business": {
                    "BusinessNm": "Keystone Manufacturing LLC",
                    "TradeNm": "Keystone Mfg",
                    "IsEIN": true,
                    "PayerRef":"Keystone123",
                    "EINorSSN": "236789128",
                    "Email": "info@keystonemfg.com",
                    "ContactNm": "Michael Turner",
                    "Phone": "7175554821",
                    "PhoneExtn": "101",
                    "Fax": "7175554899",
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "Michael Turner",
                        "Phone": "7175554821",
                        "BusinessMemberType": "ADMINISTRATOR"
                    },
                    "KindOfEmployer": "NONGOVT501C",
                    "KindOfPayer": "REGULAR941",
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "1500 Market Street",
                        "Address2": "Suite 1200",
                        "City": "Philadelphia",
                        "State": "PA",
                        "ZipCd": "19102"
                    },
                    "ForeignAddress": {
                        "Address1": null,
                        "Address2": null,
                        "City": null,
                        "ProvinceOrStateNm": null,
                        "Country": null,
                        "PostalCd": null
                    }
                }
            },
            "ReturnData": {
                "FormW3": {
                    "WHIdNum": "00007000",
                    "DepositSchedule": "MONTHLY",
                    "TotPayrollAmt": "4000.00",
                    "TaxWH": "3500",
                    "TaxPaid": "2000.00",
                    "Overpayment": "0.00",
                    "BalanceDue": "1500.00",
                    "MonthlyWHDeposit": {
                        "Month1WHAmt": 1000,
                        "Month2WHAmt": 1500,
                        "Month3WHAmt": 1000
                    },
                    "SemiMonthlyWHDeposit": {
                        "Month1FHWHAmt": 0,
                        "Month1SHWHAmt": 0,
                        "Month2FHWHAmt": 0,
                        "Month2SHWHAmt": 0,
                        "Month3FHWHAmt": 0,
                        "Month3SHWHAmt": 0
                    },
                    "SemiWeeklyWHDeposit": {
                        "Period1": 0,
                        "Period2": 0,
                        "Period3": 0,
                        "Period4": 0,
                        "Period5": 0,
                        "Period6": 0,
                        "Period7": 0,
                        "Period8": 0,
                        "Period9": 0,
                        "Period10": 0,
                        "Period11": 0,
                        "Period12": 0,
                        "Period13": 0,
                        "Period14": 0,
                        "Period15": 0,
                        "Period16": 0,
                        "Period17": 0,
                        "Period18": 0,
                        "Period19": 0,
                        "Period20": 0,
                        "Period21": 0,
                        "Period22": 0,
                        "Period23": 0,
                        "Period24": 0,
                        "Period25": 0,
                        "Period26": 0,
                        "Period27": 0
                    },
                    "TotQtrTaxLiabAmt": 3500
                }
            }
        }
    ]
}

Response JSON

Success Response - This is a sample response for successful API requests.

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019d1a68-e397-754b-ab1c-4c2edc8876ec",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "2fa5381e-8c36-4fbd-8d66-8b0db29d3d90",
          "PayerRef": "bdfjjghghdhgfh",
          "RecordId": "019d1a68-fa42-753f-8b18-5d3b60fa6d1f",
          "FormType": "WTH10001",
          "Status": "CREATED",
          "StatusTs": "2026-03-23 16:51:30 +05:30",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON