Version: 2.0.0

ValidateForm

Use this endpoint to validate 1099-PATR data against IRS business rules before creating the form.

POST form1099patr/ValidateForm

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission on the whole. It contains information like - Tax Year - IsScheduleFiling & ScheduleFiling service details
TaxYear	string	Tax year of Form 1099-PATR to be filed. Allowed values "2025", "2026"
IsFederal	Boolean	Federal Filing will be enabled when the value is True. Form 1099-NEC will be sent directly to the IRS.
IsState	Boolean	State Filing will be enabled when the value is True. Form 1099-NEC will be directly filed with the respective recipient states. Note: State Filing will not be created for the states that do not require State filing.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access/email).
DistributionDetails	object[]	Distribution configuration. Required when IsDistribution is TRUE.
DistributionType	string	Recipient copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
IsScheduleFiling	Boolean	When true, schedule filing services will be enabled for Form 1099-PATR returns under this submission.
ScheduleFiling	object[]	Contains the preferred date to submit the returns to the IRS. Note: Required only when `IsScheduleFiling` is True.
EfileDate	string	Date of Schedule Filing. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2026 or 01-25-2026
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRef	string	Optional Your unique identifier for the payer. Can replace `BusinessId` in future requests. Size Range: 50
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when `TINType` is `SSN`. Provide individual name fields instead of `BusinessNm`.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional Suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the business. Required when `TINType` is `EIN`. Size Range: 75
NameCtrl	string	Name control of the business as registered with the IRS. Size Range: 3-4
DBADetails	object[]	Optional DBA (Doing Business As) information.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Unique identifier for the DBA. Size Range: 1-50
DBAId	Guid	TaxBandits-generated DBA identifier. Returned in the response.
IsDefaultDBA	Boolean	When TRUE, marks this DBA as the default.
Address	object[]	Address information of DBA.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrStateNm	String	DBA's province or state name. Allowed values When the country code is US: "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", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	DBA's ZIP code. Size Range: 5-16
Country	String	DBA's 2-character country code. Allowed values "US", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AU", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DO", "DM", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RS", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TK", "TF", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
Address	object	Business address details.
Address1	string	Street address or PO Box of the business. Size Range: 46
Address2	string	Optional Suite or apartment number of the business. Size Range: 46
City	string	City of the business. Size Range: 50
ProvinceOrState	string	Province or state name of the business. When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	ZIP code of the business. Size Range: 5-16
Country	String	2-character country code of the business. Allowed values "US", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AU", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DO", "DM", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RS", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TK", "TF", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
ContactDetails	object[]	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person. Size Range: 20
MiddleNm	string	Optional Middle name of the contact person. Size Range: 20
LastNm	string	Last name of the contact person. Size Range: 20
Suffix	string	Optional The suffix of the contact person. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Phone number of the contact person. Size Range: 10 digits
PhoneExtn	string	Optional Phone extension number. Size Range: 5
Fax	string	Optional Fax number of the contact person. Size Range: 10
ReturnData	object[]	Contains information about the recipient details and Form 1099-PATR details.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. Size Range: 50
ReturnManifest	object[]	Filing options for this record.
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True. Form 1099-PATR will be sent directly to the IRS.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Form 1099-PATR will be directly filed with the respective recipient states. Note: State Filing will not be created for the states that do not require State filing.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access / email).
DistributionDetails	object[]	Distribution configuration. Required when `IsDistribution` is TRUE.
DistributionType	string	Recipient copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
IsForced	Boolean	When TRUE, TaxBandits does not verify for duplicates and will create a new return for the recipient, even it comprises the same amounts as in previously filed returns. For more information on duplicate handling for Form 1099s, please click here. Note: If there are multiple returns filed for the recipient with the same account number, TaxBandits will append 3 random numbers at the end of the account number.
Recipient	object	Object to identify recipient details.
RecipientId	Guid	A unique ID generated by TaxBandits after the return is created and will be returned in the Response. You can use this ID for your future reference to update.
PayeeRef	string	Optional Your unique identifier for the recipient. Can replace `RecipientId` in future requests. Size Range: 50
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed. Allowed values `"PLAIN_TIN"` - Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	TIN type of the recipient. Allowed values "EIN", "SSN", "ATIN", "ITIN", "NA"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when `TINType` is `SSN`. Provide individual name fields instead of `BusinessNm`.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional The middle name of the individual. Size Range: 20
LastNm	string	Last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual’s name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	Name control of the business as registered with the IRS. Size Range: 3-4
DBADetails	Object	Optional DBA (Doing Business As) information.
DBAId	GUID	TaxBandits-generated DBA identifier. Returned in the response.
DBANm	String	Name of the DBA. Size Range: 75
DBARef	String	Your unique identifier for this DBA. 1-50 characters
Address	object[]	Address information of DBA
Address1	String	Street address or PO Box. Max 46 characters
Address2	String	Optional Suite or apartment number. Max 46 characters
City	String	DBA’s city. Max 50 characters
ProvinceOrState	String	DBA’s province or state name. Allowed valuesWhen the country code is US : 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", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	DBA’s ZIP code. 5 - 16 characters
Country	String	DBA’s 2-character country code. Allowed values "US", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AU", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DO", "DM", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RS", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TK", "TF", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
DOB	String	Optional Date of Birth of the recipient. Format: MM/DD/YYYY
Address	Object	Primary address of the recipient.
Address1	String	Street address or PO Box of the recipient. Size Range: 46
Address2	String	Optional Suite or apartment number of the recipient. Size Range: 46
City	String	City of the recipient. Size Range: 50
ProvinceOrState	String	Province or state name of the recipient. Allowed valuesWhen the country code is US : 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", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	ZIP code of the recipient. Size Range: 5 - 16
Country	String	2-character country code of the recipient. 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", "US", "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", "MP", "MU", "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"
Email	string	Email address of the recipient. Size Range: 100 Note: Required if the DistributionType is `ONLINE_ACCESS` is set to true
Fax	string	Optional Fax number of the recipient. Size Range: 10
Phone	string	Optional Phone number of the recipient. Size Range: 10
PATRFormData	object	Form 1099-PATR specific data for the recipient.
PatronageDiv	number	Box 1. Patron's share of total patronage dividends paid in cash, including qualified or consent checks, qualified written notices of allocation (face amount), and other property (except nonqualified written notices of allocation) allowable as a deduction under section 1382(b)(1). Range: 0-9,999,999,999.99
NonPatronageDist	number	Box 2. For farmer's cooperatives exempt under section 521 only - patron's share of the total amount paid in cash, qualified written notices of allocation (face amount), and other property on a patronage basis with respect to earnings from nonpatronage sources, allowable as a deduction under section 1382(c)(2)(A). Range: 0-9,999,999,999.99
PerUnitAllocations	number	Box 3. Patron's share of the total per-unit retain allocations paid in cash, qualified per-unit retain certificates (face amount), and other property (except nonqualified per-unit retain certificates) allowable as a deduction under section 1382(b)(3). Range: 0-9,999,999,999.99
FedTaxWH	number	Box 4. Backup withholding on patronage payments. Applies to persons who have not furnished their TIN on payments required to be reported in boxes 1, 2, 3, and 5 to the extent such payments are in cash or qualified check. Note: This value should be less than 40% of the sum of boxes 1, 2, 3, and 5. Range: 0-9,999,999,999.99
RedmNonQualNotices	number	Box 5. Amount of redeemed nonqualified written notices of allocation paid as a patronage dividend, and redeemed nonqualified per-unit retain certificates paid as a per-unit retain allocation. See sections 1382(b)(2) and (4). Range: 0-9,999,999,999.99
Sec199AgDeduction	number	Box 6. For specified agricultural and horticultural cooperatives only - patron's share of the section 199A(g) deduction claimed by the cooperative and passed through to the patron. Cannot exceed 9% of the qualified payments reported in box 7. Do not reduce the amounts in box 1 or box 3 by this amount. Range: 0-9,999,999,999.99
QualPymtsSec199Ab7	number	Box 7. For specified agricultural and horticultural cooperatives only - qualified payments paid to the patron. Required whether or not any section 199A(g) deduction is passed through. See section 199A(b)(7). Range: 0-9,999,999,999.99
Sec199AaQualItems	number	Box 8. Amounts reported to patrons that are qualified items of income, gain, deduction, or loss from qualified trades or businesses that are not a specified service trade or business (SSTB) for purposes of section 199A. Examples of income that are not qualified items include tax-exempt income and capital gains. Range: 0-9,999,999,999.99
Sec199AaSSTbItems	number	Box 9. Amounts reported to patrons that are qualified items from otherwise qualified trades or businesses that are an SSTB for purposes of section 199A. Examples of SSTBs include services in the fields of health, law, and accounting. Range: 0-9,999,999,999.99
InvestmentCredit	number	Box 10. Patron's share of the total investment credit. Range: 0-9,999,999,999.99
WorkOpporCredit	number	Box 11. Patron's share of the total work opportunity credit. Range: 0-9,999,999,999.99
OtherCreditsAndDeductions	number	Box 12. Amount of each applicable credit or deduction, including empowerment zone employment credit (Form 8844), low sulfur diesel fuel production credit (Form 8896), credit for small employer health insurance premiums (Form 8941), credit for employer differential wage payments (Form 8932), deduction for capital costs by small refiner cooperatives, and small agri-biodiesel producer credit (Form 8864). Range: 0-9,999,999,999.99
CreditsAndDeductionsType	string	Box 12 (type). Type of each credit or deduction reported in box 12. Refer to IRS instructions for allowed values. Allowed values "12A", "12B", "12C", "12D", "12E", "12F"
IsSpecifiedCoop	boolean	Box 13. When TRUE, identifies the reporting entity as a specified agricultural or horticultural cooperative as defined in section 199A(g)(4)(A) - engaged in the manufacturing, production, growth, extraction, or marketing of agricultural or horticultural products.
AccountNum	string	Account number assigned by the payer to distinguish between multiple Form 1099-PATR returns filed for the same recipient. The IRS encourages designating an account number for all Forms 1099-PATR filed. 4-20 characters Note: If the account number matches a previously filed return, TaxBandits will automatically append 3 random digits to ensure uniqueness.
Is2ndTINnot	boolean	When TRUE, indicates the payer has been notified by the IRS twice within 3 calendar years for providing an incorrect TIN and does not want the IRS to send further notices about this account.

Response Body

Field	Type	Description
ErrorRecords	object[]	Shows the detailed information about the error status of the Form 1099-PATR records that failed validation.
SequenceId	string	The unique reference ID for the submission that identifies a particular record. The Sequence ID is returned in the response for your reference.
Errors	object[]	Shows detailed error information for the record.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Errors	object[]	Shows detailed error information at the submission level.
Code	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Type	string	Type of validation error.

Request JSON

Sample	Description	Action
Sample 1	Create a Form 1099-PATR return with both Business and Recipient TIN as EIN

Sample 1

{
  "SubmissionManifest": {
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    },
    "IsScheduleFiling": true,
    "ScheduleFiling": {
      "EfileDate": "01/25/2026"
    }
  },
  "ReturnHeader": {
    "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "45-9875461"
      },
      "IndividualNm": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
        "DBANm": "Iceberg Icecreams",
        "DBARef": "DBA1001",
        "DBAId": null,
        "IsDefaultDBA": true,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        }
      },
      "Email": "james@sample.com",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr",
        "Phone": "8035551234",
        "PhoneExtn": "101",
        "Email": "contact@snowdaze.com",
        "Fax": "8035555678"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": false,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsForced": false
      },
      "Recipient": {
        "RecipientId": null,
        "PayeeRef": "DAI001",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
        },
        "NameCtrl": null,
        "BusinessNm": "Dairy Delights LLC",
        "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "SC",
            "ZipCd": "29730",
            "Country": "US"
          }
        },
        "FirstNm": null,
        "MiddleNm": null,
        "LastNm": null,
        "Suffix": null,
        "DOB": null,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        },
        "Email": "shawn@sample.com",
        "Fax": "6634567890",
        "Phone": "9634567890"
      },
      "PATRFormData": {
        "PatronageDiv": 1000.56,
        "NonPatronageDist": 1000.91,
        "PerUnitAllocations": 500.49,
        "FedTaxWH": 1240.86,
        "RedmNonQualNotices": 600.21,
        "Sec199AgDeduction": 70.4,
        "QualPymtsSec199Ab7": 800.9,
        "Sec199AaQualItems": 1000.31,
        "Sec199AaSSTBItems": 280,
        "InvestmentCredit": 790.22,
        "WorkOpporCredit": 150,
        "OtherCreditsAndDeductions": 500.5,
        "CreditsAndDeductionsType": "12A",
        "IsSpecifiedCoop": true,
        "Is2ndTINnot": true,
        "AccountNum": null
      }
    }
  ]
}

Response JSON

Response	Description	Action
200	Success Response - You'll get the below response when the request is processed successfully.

Response: 200

{
  "ErrorRecords": null,
  "Errors": null
}

  package main

  import (
      "fmt"
      "io"
      "net/http"
      "strings"
  )

  func main() {
      url := "<APIURL>/v2.0.0/Form1099patr/ValidateForm"
      method := "POST"

      payload := strings.NewReader(`{
  "SubmissionManifest": {
      "TaxYear": "2026",
      "IsFederal": true,
      "IsState": true,
      "IsDistribution": true,
      "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
      },
      "IsScheduleFiling": true,
      "ScheduleFiling": {
      "EfileDate": "01/25/2026"
      }
  },
  "ReturnHeader": {
      "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
      },
      "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": null,
          "IsDefaultDBA": true,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          }
      },
      "Email": "james@sample.com",
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
      }
      }
  },
  "ReturnData": [
      {
      "SequenceId": "1",
      "ReturnManifest": {
          "IsFederal": true,
          "IsState": false,
          "IsDistribution": true,
          "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": false
      },
      "Recipient": {
          "RecipientId": null,
          "PayeeRef": "DAI001",
          "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
          },
          "NameCtrl": null,
          "BusinessNm": "Dairy Delights LLC",
          "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
          }
          },
          "FirstNm": null,
          "MiddleNm": null,
          "LastNm": null,
          "Suffix": null,
          "DOB": null,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          },
          "Email": "shawn@sample.com",
          "Fax": "6634567890",
          "Phone": "9634567890"
      },
      "PATRFormData": {
          "PatronageDiv": 1000.56,
          "NonPatronageDist": 1000.91,
          "PerUnitAllocations": 500.49,
          "FedTaxWH": 1240.86,
          "RedmNonQualNotices": 600.21,
          "Sec199AgDeduction": 70.4,
          "QualPymtsSec199Ab7": 800.9,
          "Sec199AaQualItems": 1000.31,
          "Sec199AaSSTBItems": 280,
          "InvestmentCredit": 790.22,
          "WorkOpporCredit": 150,
          "OtherCreditsAndDeductions": 500.5,
          "CreditsAndDeductionsType": "12A",
          "IsSpecifiedCoop": true,
          "Is2ndTINnot": true,
          "AccountNum": null
      }
      }
  ]
  }`)

      client := &http.Client{}

      req, err := http.NewRequest(method, url, payload)
      if err != nil {
          fmt.Println("Error creating request:", err)
          return
      }

      req.Header.Add("Authorization", "<ACCESS_TOKEN>")
      req.Header.Add("Content-Type", "application/json")

      res, err := client.Do(req)
      if err != nil {
          fmt.Println("Error sending request:", err)
          return
      }
      defer res.Body.Close()

      body, err := io.ReadAll(res.Body)
      if err != nil {
          fmt.Println("Error reading response:", err)
          return
      }

      fmt.Println(string(body))
  }

  const axios = require('axios');
  let data = JSON.stringify({
  "SubmissionManifest": {
      "TaxYear": "2026",
      "IsFederal": true,
      "IsState": true,
      "IsDistribution": true,
      "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
      },
      "IsScheduleFiling": true,
      "ScheduleFiling": {
      "EfileDate": "01/25/2026"
      }
  },
  "ReturnHeader": {
      "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
      },
      "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": null,
          "IsDefaultDBA": true,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          }
      },
      "Email": "james@sample.com",
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
      }
      }
  },
  "ReturnData": [
      {
      "SequenceId": "1",
      "ReturnManifest": {
          "IsFederal": true,
          "IsState": false,
          "IsDistribution": true,
          "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": false
      },
      "Recipient": {
          "RecipientId": null,
          "PayeeRef": "DAI001",
          "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
          },
          "NameCtrl": null,
          "BusinessNm": "Dairy Delights LLC",
          "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
          }
          },
          "FirstNm": null,
          "MiddleNm": null,
          "LastNm": null,
          "Suffix": null,
          "DOB": null,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          },
          "Email": "shawn@sample.com",
          "Fax": "6634567890",
          "Phone": "9634567890"
      },
      "PATRFormData": {
          "PatronageDiv": 1000.56,
          "NonPatronageDist": 1000.91,
          "PerUnitAllocations": 500.49,
          "FedTaxWH": 1240.86,
          "RedmNonQualNotices": 600.21,
          "Sec199AgDeduction": 70.4,
          "QualPymtsSec199Ab7": 800.9,
          "Sec199AaQualItems": 1000.31,
          "Sec199AaSSTBItems": 280,
          "InvestmentCredit": 790.22,
          "WorkOpporCredit": 150,
          "OtherCreditsAndDeductions": 500.5,
          "CreditsAndDeductionsType": "12A",
          "IsSpecifiedCoop": true,
          "Is2ndTINnot": true,
          "AccountNum": null
      }
      }
  ]
  });

  let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/Form1099patr/ValidateForm',
  headers: { 
      'Authorization': '<ACCESS_TOKEN>', 
      'Content-Type': 'application/json'
  },
  data : data
  };

  axios.request(config)
  .then((response) => {
  console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
  console.log(error);
  });

  import http.client
  import json

  conn = http.client.HTTPSConnection("<APIURL>")
  payload = json.dumps({
  "SubmissionManifest": {
      "TaxYear": "2026",
      "IsFederal": True,
      "IsState": True,
      "IsDistribution": True,
      "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
      },
      "IsScheduleFiling": True,
      "ScheduleFiling": {
      "EfileDate": "01/25/2026"
      }
  },
  "ReturnHeader": {
      "Business": {
      "PayerRef": "Snow123",
      "BusinessId": None,
      "IsDefaultBusiness": True,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
      },
      "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": None,
          "IsDefaultDBA": True,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          }
      },
      "Email": "james@sample.com",
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
      }
      }
  },
  "ReturnData": [
      {
      "SequenceId": "1",
      "ReturnManifest": {
          "IsFederal": True,
          "IsState": False,
          "IsDistribution": True,
          "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": False
      },
      "Recipient": {
          "RecipientId": None,
          "PayeeRef": "DAI001",
          "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
          },
          "NameCtrl": None,
          "BusinessNm": "Dairy Delights LLC",
          "DBADetails": {
          "DBAId": None,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
          }
          },
          "FirstNm": None,
          "MiddleNm": None,
          "LastNm": None,
          "Suffix": None,
          "DOB": None,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          },
          "Email": "shawn@sample.com",
          "Fax": "6634567890",
          "Phone": "9634567890"
      },
      "PATRFormData": {
          "PatronageDiv": 1000.56,
          "NonPatronageDist": 1000.91,
          "PerUnitAllocations": 500.49,
          "FedTaxWH": 1240.86,
          "RedmNonQualNotices": 600.21,
          "Sec199AgDeduction": 70.4,
          "QualPymtsSec199Ab7": 800.9,
          "Sec199AaQualItems": 1000.31,
          "Sec199AaSSTBItems": 280,
          "InvestmentCredit": 790.22,
          "WorkOpporCredit": 150,
          "OtherCreditsAndDeductions": 500.5,
          "CreditsAndDeductionsType": "12A",
          "IsSpecifiedCoop": True,
          "Is2ndTINnot": True,
          "AccountNum": None
      }
      }
  ]
  })
  headers = {
  'Authorization': '<ACCESS_TOKEN>',
  'Content-Type': 'application/json'
  }
  conn.request("POST", "/v2.0.0/Form1099patr/ValidateForm", payload, headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.Post, "<APIURL>/v2.0.0/Form1099patr/ValidateForm");
  request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
  var content = new StringContent("{
  "SubmissionManifest": {
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    },
    "IsScheduleFiling": true,
    "ScheduleFiling": {
      "EfileDate": "01/25/2026"
    }
  },
  "ReturnHeader": {
    "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "45-9875461"
      },
      "IndividualNm": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
        "DBANm": "Iceberg Icecreams",
        "DBARef": "DBA1001",
        "DBAId": null,
        "IsDefaultDBA": true,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        }
      },
      "Email": "james@sample.com",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr",
        "Phone": "8035551234",
        "PhoneExtn": "101",
        "Email": "contact@snowdaze.com",
        "Fax": "8035555678"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": false,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsForced": false
      },
      "Recipient": {
        "RecipientId": null,
        "PayeeRef": "DAI001",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
        },
        "NameCtrl": null,
        "BusinessNm": "Dairy Delights LLC",
        "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "SC",
            "ZipCd": "29730",
            "Country": "US"
          }
        },
        "FirstNm": null,
        "MiddleNm": null,
        "LastNm": null,
        "Suffix": null,
        "DOB": null,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        },
        "Email": "shawn@sample.com",
        "Fax": "6634567890",
        "Phone": "9634567890"
      },
      "PATRFormData": {
        "PatronageDiv": 1000.56,
        "NonPatronageDist": 1000.91,
        "PerUnitAllocations": 500.49,
        "FedTaxWH": 1240.86,
        "RedmNonQualNotices": 600.21,
        "Sec199AgDeduction": 70.4,
        "QualPymtsSec199Ab7": 800.9,
        "Sec199AaQualItems": 1000.31,
        "Sec199AaSSTBItems": 280,
        "InvestmentCredit": 790.22,
        "WorkOpporCredit": 150,
        "OtherCreditsAndDeductions": 500.5,
        "CreditsAndDeductionsType": "12A",
        "IsSpecifiedCoop": true,
        "Is2ndTINnot": true,
        "AccountNum": null
      }
    }
  ]
}", null, "application/json");
  request.Content = content;
  var response = await client.SendAsync(request);
  response.EnsureSuccessStatusCode();
  Console.WriteLine(await response.Content.ReadAsStringAsync());

  require "uri"
  require "json"
  require "net/http"

  url = URI("<APIURL>/v2.0.0/Form1099patr/ValidateForm")

  http = Net::HTTP.new(url.host, url.port);
  request = Net::HTTP::Post.new(url)
  request["Authorization"] = "<ACCESS_TOKEN>"
  request["Content-Type"] = "application/json"
  request.body = JSON.dump({
  "SubmissionManifest": {
      "TaxYear": "2026",
      "IsFederal": true,
      "IsState": true,
      "IsDistribution": true,
      "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
      },
      "IsScheduleFiling": true,
      "ScheduleFiling": {
      "EfileDate": "01/25/2026"
      }
  },
  "ReturnHeader": {
      "Business": {
      "PayerRef": "Snow123",
      "BusinessId": "nil",
      "IsDefaultBusiness": true,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
      },
      "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": "nil",
          "IsDefaultDBA": true,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          }
      },
      "Email": "james@sample.com",
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
      }
      }
  },
  "ReturnData": [
      {
      "SequenceId": "1",
      "ReturnManifest": {
          "IsFederal": true,
          "IsState": false,
          "IsDistribution": true,
          "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": false
      },
      "Recipient": {
          "RecipientId": "nil",
          "PayeeRef": "DAI001",
          "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
          },
          "NameCtrl": "nil",
          "BusinessNm": "Dairy Delights LLC",
          "DBADetails": {
          "DBAId": "nil",
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
          }
          },
          "FirstNm": "nil",
          "MiddleNm": "nil",
          "LastNm": "nil",
          "Suffix": "nil",
          "DOB": "nil",
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          },
          "Email": "shawn@sample.com",
          "Fax": "6634567890",
          "Phone": "9634567890"
      },
      "PATRFormData": {
          "PatronageDiv": 1000.56,
          "NonPatronageDist": 1000.91,
          "PerUnitAllocations": 500.49,
          "FedTaxWH": 1240.86,
          "RedmNonQualNotices": 600.21,
          "Sec199AgDeduction": 70.4,
          "QualPymtsSec199Ab7": 800.9,
          "Sec199AaQualItems": 1000.31,
          "Sec199AaSSTBItems": 280,
          "InvestmentCredit": 790.22,
          "WorkOpporCredit": 150,
          "OtherCreditsAndDeductions": 500.5,
          "CreditsAndDeductionsType": "12A",
          "IsSpecifiedCoop": true,
          "Is2ndTINnot": true,
          "AccountNum": "nil"
      }
      }
  ]
  })

  response = http.request(request)
  puts response.read_body

  OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
  MediaType mediaType = MediaType.parse("application/json");
  RequestBody body = RequestBody.create(mediaType, "{
  "SubmissionManifest": {
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    },
    "IsScheduleFiling": true,
    "ScheduleFiling": {
      "EfileDate": "01/25/2026"
    }
  },
  "ReturnHeader": {
    "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "45-9875461"
      },
      "IndividualNm": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
        "DBANm": "Iceberg Icecreams",
        "DBARef": "DBA1001",
        "DBAId": null,
        "IsDefaultDBA": true,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        }
      },
      "Email": "james@sample.com",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr",
        "Phone": "8035551234",
        "PhoneExtn": "101",
        "Email": "contact@snowdaze.com",
        "Fax": "8035555678"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": false,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsForced": false
      },
      "Recipient": {
        "RecipientId": null,
        "PayeeRef": "DAI001",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
        },
        "NameCtrl": null,
        "BusinessNm": "Dairy Delights LLC",
        "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "SC",
            "ZipCd": "29730",
            "Country": "US"
          }
        },
        "FirstNm": null,
        "MiddleNm": null,
        "LastNm": null,
        "Suffix": null,
        "DOB": null,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        },
        "Email": "shawn@sample.com",
        "Fax": "6634567890",
        "Phone": "9634567890"
      },
      "PATRFormData": {
        "PatronageDiv": 1000.56,
        "NonPatronageDist": 1000.91,
        "PerUnitAllocations": 500.49,
        "FedTaxWH": 1240.86,
        "RedmNonQualNotices": 600.21,
        "Sec199AgDeduction": 70.4,
        "QualPymtsSec199Ab7": 800.9,
        "Sec199AaQualItems": 1000.31,
        "Sec199AaSSTBItems": 280,
        "InvestmentCredit": 790.22,
        "WorkOpporCredit": 150,
        "OtherCreditsAndDeductions": 500.5,
        "CreditsAndDeductionsType": "12A",
        "IsSpecifiedCoop": true,
        "Is2ndTINnot": true,
        "AccountNum": null
      }
    }
  ]
}");
  Request request = new Request.Builder()
  .url("<APIURL>/v2.0.0/Form1099patr/ValidateForm")
  .method("POST", body)
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .addHeader("Content-Type", "application/json")
  .build();
  Response response = client.newCall(request).execute();

  curl --location '<APIURL>/v2.0.0/Form1099patr/ValidateForm'   --header 'Authorization: <ACCESS_TOKEN>'   --header 'Content-Type: application/json'   --data-raw '{
  "SubmissionManifest": {
      "TaxYear": "2026",
      "IsFederal": true,
      "IsState": true,
      "IsDistribution": true,
      "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
      },
      "IsScheduleFiling": true,
      "ScheduleFiling": {
      "EfileDate": "01/25/2026"
      }
  },
  "ReturnHeader": {
      "Business": {
      "PayerRef": "Snow123",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
      },
      "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": null,
          "IsDefaultDBA": true,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          }
      },
      "Email": "james@sample.com",
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
      }
      }
  },
  "ReturnData": [
      {
      "SequenceId": "1",
      "ReturnManifest": {
          "IsFederal": true,
          "IsState": false,
          "IsDistribution": true,
          "DistributionDetails": {
          "DistributionType": "POSTAL_MAIL",
          "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": false
      },
      "Recipient": {
          "RecipientId": null,
          "PayeeRef": "DAI001",
          "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
          },
          "NameCtrl": null,
          "BusinessNm": "Dairy Delights LLC",
          "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
          }
          },
          "FirstNm": null,
          "MiddleNm": null,
          "LastNm": null,
          "Suffix": null,
          "DOB": null,
          "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
          },
          "Email": "shawn@sample.com",
          "Fax": "6634567890",
          "Phone": "9634567890"
      },
      "PATRFormData": {
          "PatronageDiv": 1000.56,
          "NonPatronageDist": 1000.91,
          "PerUnitAllocations": 500.49,
          "FedTaxWH": 1240.86,
          "RedmNonQualNotices": 600.21,
          "Sec199AgDeduction": 70.4,
          "QualPymtsSec199Ab7": 800.9,
          "Sec199AaQualItems": 1000.31,
          "Sec199AaSSTBItems": 280,
          "InvestmentCredit": 790.22,
          "WorkOpporCredit": 150,
          "OtherCreditsAndDeductions": 500.5,
          "CreditsAndDeductionsType": "12A",
          "IsSpecifiedCoop": true,
          "Is2ndTINnot": true,
          "AccountNum": 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

ValidateForm

ValidateForm

Request Body

Response Body

Sample 1

Response: 200