Version: 2.0

ValidateForm

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

If you need to validate the 1099-MISC forms that are already created in TaxBandits, use the Validate endpoint.

POST form1099misc/validateform

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object[]	Submission information containing Submission ID, Tax Year, and Schedule Filing details.
TaxYear	string	Tax year of Form 1099-MISC to be filed. Allowed values Allowed values: "2025", "2026"
IsScheduleFiling	Boolean	When true, schedule filing services will be enabled for Form 1099-MISC returns under this submission.
ScheduleFiling	object[]	Contains the preferred date to submit the returns to the IRS. Required when IsScheduleFiling is True.
EfileDate	string	Date of Schedule Filing. Format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Unique Business ID generated by TaxBandits. If provided, business details are not required.
PayerRef	string	Optional. Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
IsDefaultBusiness	Boolean	When 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.
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	First name of the individual. Size Range: 20
MiddleNm	string	Optional. Middle name of the individual. Size Range: 20
LastNm	string	Last name of the individual. Size Range: 20
Suffix	string	Optional. Suffix of the individual's name. Allowed: "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.
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
ProvinceOrState	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[]	Primary address of the business Size Range: ..100
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. 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	ZIP code of the business. Size Range: 5-16
Country	String	-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. Suffix of the contact person. Allowed: "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Optional. 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 digits
Fax	string	Optional. Fax number of the contact person. Size Range: 10 digits
ReturnData	object[]	Contains information about the recipient details and Form 1099-MISC details.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. Size Range: 50
ReturnManifest	object[]	Filing options for this record.
IsFederal	Boolean	When TRUE, federal filing is enabled. Form 1099-MISC will be sent directly to the IRS.
IsState	Boolean	When TRUE, state filing is enabled. Form will be filed with respective recipient states. Note: State Filing will not be created for 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: "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed: "USPS_FIRST_CLASS"
IsForced	Boolean	When TRUE, TaxBandits does not verify for duplicates and creates a new return. Note: If multiple returns are filed with the same account number, TaxBandits appends 3 random numbers at the end.
Recipient	object	Object to identify the recipient details.
RecipientId	Guid	Unique ID generated by TaxBandits after the return is created. Use this ID for future updates.
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: "PLAIN_TIN"
TINType	string	TIN type of the recipient. Allowed: "EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"
TIN	string	The TIN value according to the Format selected.
TINType	string	TIN type of the recipient. Allowed: "EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNm	string	First name of the individual. Size Range: 20
MiddleNm	string	Optional. Middle name of the individual. Size Range: 20
LastNm	string	Last name of the individual. Size Range: 20
Suffix	string	Optional. Suffix of the individual's name. Allowed: "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. Size Range: 1-50
Address	object[]	Address information of DBA.
Address1	string	Street address or PO Box. Max 46 characters
Address2	string	Optional. Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrState	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 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. Size Range: 46
Address2	string	Optional. Suite or apartment number. Size Range: 46
City	string	City of the recipient. Size Range: 50
ProvinceOrState	string	Province or state name. See allowed values below.
ZipCd	string	ZIP code of the recipient. Size Range: 5-16 characters
Country	String	Province or state name of the recipient. 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"
Email	string	Email address of the recipient. Size Range: 100. Required if DistributionType is ONLINE_ACCESS.
Fax	string	Optional. Fax number of the recipient. Size Range: 10
Phone	string	Optional. Phone number of the recipient. Size Range: 10
MISCFormData	object	Recipient's Form 1099-MISC information.
Rents	number	Amount of rent paid to the recipient that exceeds the reporting threshold. Threshold: $600 (pre-2026) / $2,000 (2026+). Range: 0-9999999999.99
Royalties	number	Gross royalty payments of $10 or more. Size Range: 0-9999999999.99
OtherIncome	number	Amount of other income paid to the recipient that exceeds the reporting threshold and cannot be reported in any other box on the form. The threshold is $600 for tax years before 2026 and $2,000 for tax year 2026 and later. Range: 0-9999999999.99
FedIncomeTaxWH	number	Federal income tax withheld - Gets the backup withholding. For example, persons who have not furnished their TIN to their Employer are subject to withholding of payments required to be reported in boxes 1, 2 (net of severance taxes), 3, 5 (to the extent paid in cash), 6, 8, 9, and 10.
Size Range: 0-9999999999.99
Note: This value should be less than 40% of the sum of boxes 1, 2, 3, 5, 6, 8, 9 and 10.
FishingBoatProceeds	number	Fishing boat proceeds - Gets an individual's share of all proceeds from the sale of a catch. Size Range: 0-9999999999.99
MedHealthcarePymts	number	Medical and health care payments - Gets the payments made in excess of $600 or more to a physician, other supplier or provider of medical or health care services. Range: 0-9999999999.99
IsDirectSales	Boolean	Payer made direct sales of $5,000 or more of consumer products to a buyer (recipient) for resale - When true, identifies the payer who made $5,000 or more of selling consumer products to a person on a buy-sell, deposit-commission, or other commission basis for resale (by the buyer or any other person) anywhere other than in a permanent retail establishment.
SubstitutePymts	number	Substitute payments in lieu of dividends or interest - Gets the aggregate payments of at least $10 of substitute payments received by a broker for a customer in lieu of dividends or tax-exempt interest as a result of a loan of a customer's securities. Size Range: 0-9999999999.99
CropInsurance	number	Gets the crop insurance proceeds of $600 or more paid to farmers by insurance companies. Size Range: 0-9999999999.99
GrossProceeds	number	Gets the gross proceeds in excess of $600 paid to an attorney in conMISCtion with legal services, regardless of services performed for the payer. Size Range: 0-9999999999.99
FishPurForResale	number	Gets the total cash payments of $600 or more paid during the year to any person who is engaged in the trade or business of catching fish. Size Range: 0-9999999999.99
Sec409ADeferrals	number	Gets the total amount deferred during the year of at least $600 for the nonemployee under all nonqualified plans. Size Range: 0-9999999999.99
CashTips	number	Cash tips are paid to the recipient.
Size Range: 0 – 9999999999.99
Note: This field is applicable for TY 2026
TTOC1	string	Treasury Tipped Occupation code 1.
Size Range: ..10
Note: This field is applicable for TY 2026
TTOC2	string	Treasury Tipped Occupation code 2.
Size Range: ..10
Note: This field is applicable for TY 2026
OvertimeComp	number	Overtime compensation.
Size Range: 0 – 9999999999.99
Note: This field is applicable for TY 2026
IsFATCA	Boolean	When true, it identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-MISC) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
EPP	number	Excess golden parachute payments. Specify the amount over the base amount (the average annual compensation for services includible in the individual's gross income over the most recent 5 tax years)
Size Range: 0-9999999999.99
Note: Starting Tax Year 2025, this amount is reported in Form 1099-MISC (Box 3).
NonQualDefComp	number	Nonqualified deferred compensation - Gets the amounts deferred (including earnings on amounts deferred) that are includible in income under section 409A because the nonqualified deferred compensation (NQDC) plan fails to satisfy the requirements of section 409A.
Size Range: 0-9999999999.99
Is2ndTINnot	Boolean	When TRUE, indicates the payer was notified by the IRS twice within 3 calendar years of an incorrect TIN and does not want further notices.
AccountNum	string	Optional. Account number (used when filing multiple 1099-MISCs for one recipient).
States	object[]	List of state filing details.
StateCd	string	2-character state code. 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"
StateIdNum	string	Payer's state identification number.
StateWH	number	State income tax withheld.
StateIncome	number	State income amount.

Response Body

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200, 300, etc.
ErrorRecords	object[]	Detailed information about the error status of Form 1099-MISC Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record.
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.
Type	string	Type of validation error.

Payload

Request Json

Sample	Description	Action
Sample 1	Create a Form 1099-MISC return with both Business and Recipient TIN as EIN with filling type IRIS

Sample 1

{
"SubmissionManifest": {
  "TaxYear": "2025"
},
"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": true,
      "IsDistribution": true,
      "DistributionDetails": {
        "DistributionType": "SMART_MAIL",
        "PostalType": "USPS_FIRST_CLASS"
      },
      "IsForced": false
    },
    "Recipient": {
      "RecipientId": null,
      "PayeeRef": "DAI001",
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "45-9875461"
      },
      "NameCtrl": null,
      "IndividualNm": {
          "FirstNm": null,
          "MiddleNm": null,
          "LastNm": null,
          "Suffix": 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"
        }
      },
      "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"
    },
    "MISCFormData": {
      "Rents": 1200.54,
      "Royalties": 7000.27,
      "OtherIncome": 1000.86,
      "FedIncomeTaxWH": 30.23,
      "FishingBoatProceeds": 0,
      "MedHealthcarePymts": 0,
      "IsDirectSale": false,
      "SubstitutePymts": 0,
      "CropInsurance": 0,
      "GrossProceeds": 0,
      "FishPurForResale": 0,
      "Sec409ADeferrals": 0,
      "CashTips": 500,
      "TTOC1": "102",
      "TTOC2": "103",
      "OvertimeComp": 5000,
      "IsFATCA": true,
      "EPP": 0,
      "NonQualDefComp": 12.78,
      "AccountNum": "587879879879",
      "Is2ndTINnot": true,
      "States": [
        {
          "StateCd": "AZ",
          "StateWH": 3.56,
          "StateIdNum": "047999996",
          "StateIncome": 16.36
        }
      ]
    }
  }
]
}

Response Json

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

Response: 200

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"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

ValidateForm

ValidateForm

Request Body

Response Body

Sample 1

Response: 200