Skip to main content
Version: 2.0

Get

Get

Use this endpoint to retrieve a 1099-MISC submission and its records. Provide the SubmissionId to retrieve the whole submission, optionally narrowing to a specific RecordId.

The response includes the full payer, recipient, and form data as originally submitted — useful for audit trails and displaying return details in your application.

GET form1099misc/get 

Request Params

FieldTypeDescription
SubmissionIdGuidAn unique identifier generated by TaxBandits when a 1099-MISC return is created. Mention the Form 1099-MISC return's Submission ID that you want to get.
RecordIdsGuid[]An unique identifier generated by TaxBandits when a 1099-MISC return is created. Mention the Form 1099-MISC return's Record ID that you want to get.

Response Body

FieldTypeDescription
Form1099Recordsobject[]Contains information about Form 1099-MISC returns.
SubmissionManifestobject[]Submission information containing Submission ID, Tax Year, and Schedule Filing details.
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
SubmissionManifestobject[]Submission information containing Submission ID, Tax Year, and Schedule Filing details.
TaxYearstringTax year of Form 1099-MISC to be filed.
Allowed values

Allowed values: "2025", "2026"

IsScheduleFilingBooleanWhen true, schedule filing services will be enabled for Form 1099-MISC returns under this submission.
ScheduleFilingobject[]Contains the preferred date to submit the returns to the IRS. Required when IsScheduleFiling is True.
EfileDatestringDate of Schedule Filing. Format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026
ReturnHeaderobjectContains information about the Business details.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidUnique Business ID generated by TaxBandits. If provided, business details are not required.
PayerRefstringOptional. Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
IsDefaultBusinessBooleanWhen TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
Allowed values

"PLAIN_TIN" — Pass TIN directly.

TINTypestringSpecify the TIN type of the business.
Allowed values

"EIN", "SSN"

TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringFirst name of the individual. Size Range: 20
MiddleNmstringOptional. Middle name of the individual. Size Range: 20
LastNmstringLast name of the individual. Size Range: 20
SuffixstringOptional. Suffix of the individual's name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmstringLegal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrlstringName control of the business as registered with the IRS. Size Range: 3-4
DBADetailsobject[]Optional DBA (Doing Business As) information.
DBANmstringName of the DBA. Size Range: 75
DBARefstringUnique identifier for the DBA. Size Range: 1-50
DBAIdGuidTaxBandits-generated DBA identifier.
IsDefaultDBABooleanWhen TRUE, marks this DBA as the default.
Addressobject[]Address information of DBA.
Address1stringStreet address or PO Box. Size Range: 46
Address2stringOptional. Suite or apartment number. Size Range: 46
CitystringDBA's city. Size Range: 50
ProvinceOrStateStringDBA'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.
ZipCdstringDBA's ZIP code. Size Range: 5-16
CountryStringDBA'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"

EmailstringOptional Email address of the Business Size Range: ..100
Addressobject[]Primary address of the business
Size Range: ..100
Address1stringStreet address or PO Box of the business. Size Range: 46
Address2stringOptional. Suite or apartment number of the business. Size Range: 46
CitystringCity of the business. Size Range: 50
ProvinceOrStateStringProvince 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", "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.
ZipCdstringZIP code of the business. Size Range: 5-16
CountryString-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"

ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person. Size Range: 20
MiddleNmstringOptional. Middle name of the contact person. Size Range: 20
LastNmstringLast name of the contact person. Size Range: 20
SuffixstringOptional. Suffix of the contact person.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhonestringOptional. Phone number of the contact person. Size Range: 10 digits
PhoneExtnstringOptional. Phone extension number. Size Range: 5
EmailstringOptional. Email address of the contact person. Size Range: 100
FaxstringOptional. Fax number of the contact person. Size Range: 10 digits
EmailstringOptional. Email address of the contact person. Size Range: 100
FaxstringOptional. Fax number of the contact person. Size Range: 10 digits
ReturnDataobject[]Contains information about the recipient details and Form 1099-MISC details.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular record. Size Range: 50
RecordIdGuidUnique Identifier of the Record. Mention the Form 1099-MISC return's Record ID that you want to update. If you do not provide the Record ID, then a new record will be added to the submission.
ReturnManifestobject[]Filing options for this record.
IsFederalBooleanWhen TRUE, federal filing is enabled. Form 1099-MISC will be sent directly to the IRS.
IsStateBooleanWhen 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.
IsDistributionBooleanWhen TRUE, recipient distribution is enabled (postal mail / online access / email).
DistributionDetailsobject[]Distribution configuration. Required when IsDistribution is TRUE.
DistributionTypestringRecipient copy distribution type.
Allowed values

"POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"

PostalTypestringPostal service type.
Allowed values

"USPS_FIRST_CLASS"

IsForcedBooleanWhen 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.
RecipientobjectObject to identify the recipient details.
RecipientIdGuidUnique ID generated by TaxBandits after the return is created. Use this ID for future updates.
PayeeRefstringOptional. Your unique identifier for the recipient. Can replace RecipientId in future requests. Size Range: 50
TINDetailsobjectRecipient TIN information.
FormatstringSpecifies how the TIN is passed.
Allowed values

"PLAIN_TIN"

TINTypestringTIN type of the recipient.
Allowed values

"EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"

TINstringThe TIN value according to the Format selected.
TINTypestringTIN type of the recipient.
Allowed values

"EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"

TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNmstringFirst name of the individual. Size Range: 20
MiddleNmstringOptional. Middle name of the individual. Size Range: 20
LastNmstringLast name of the individual. Size Range: 20
SuffixstringOptional. Suffix of the individual's name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmstringLegal name of the recipient business. Required when TINType is EIN. Size Range: 75
NameCtrlstringName control of the business as registered with the IRS. Size Range: 3-4
DBADetailsobjectOptional DBA (Doing Business As) information.
DBAIdGuidTaxBandits-generated DBA identifier. Returned in the response.
DBANmstringName of the DBA. Size Range: 75
DBARefstringYour unique identifier for this DBA. Size Range: 1-50
Addressobject[]Address information of DBA.
Address1stringStreet address or PO Box. Max 46 characters
Address2stringOptional. Suite or apartment number. Size Range: 46
CitystringDBA's city. Size Range: 50
ProvinceOrStateNmStringDBA's province or state name.


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", "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.
ZipCdstringDBA's ZIP code. Size Range: 5-16 characters
CountryStringDBA'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"

DOBstringOptional. Date of Birth of the recipient. Format: MM/DD/YYYY
AddressobjectPrimary address of the recipient.
Address1stringStreet address or PO Box. Size Range: 46
Address2stringOptional. Suite or apartment number. Size Range: 46
CitystringCity of the recipient. Size Range: 50
ProvinceOrStateNmStringProvince or state name.


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", "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.
ZipCdstringZIP code of the recipient. Size Range: 5-16 characters
CountryStringProvince 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"

EmailstringEmail address of the recipient. Size Range: 100. Required if DistributionType is ONLINE_ACCESS.
FaxstringOptional. Fax number of the recipient. Size Range: 10
PhonestringOptional. Phone number of the recipient. Size Range: 10
MISCFormDataobjectRecipient's Form 1099-MISC information.
RentsnumberAmount of rent paid to the recipient that exceeds the reporting threshold. Threshold: $600 (pre-2026) / $2,000 (2026+). Range: 0-9999999999.99
RoyaltiesnumberGross royalty payments of $10 or more. Size Range: 0-9999999999.99
OtherIncomenumberAmount 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
FedIncomeTaxWHnumberFederal 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.
FishingBoatProceedsnumberFishing boat proceeds - Gets an individual's share of all proceeds from the sale of a catch. Size Range: 0-9999999999.99
MedHealthcarePymtsnumberMedical 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
IsDirectSalesBooleanPayer 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.
SubstitutePymtsnumberSubstitute 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
CropInsurancenumberGets the crop insurance proceeds of $600 or more paid to farmers by insurance companies. Size Range: 0-9999999999.99
GrossProceedsnumberGets 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
FishPurForResalenumberGets 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
Sec409ADeferralsnumberGets the total amount deferred during the year of at least $600 for the nonemployee under all nonqualified plans. Size Range: 0-9999999999.99
CashTipsnumberCash tips are paid to the recipient.
Size Range: 0 – 9999999999.99
Note: This field is applicable for TY 2026
TTOC1stringTreasury Tipped Occupation code 1.
Size Range: ..10
Note: This field is applicable for TY 2026
TTOC2stringTreasury Tipped Occupation code 2.
Size Range: ..10
Note: This field is applicable for TY 2026
OvertimeCompnumberOvertime compensation.
Size Range: 0 – 9999999999.99
Note: This field is applicable for TY 2026
IsFATCABooleanWhen 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.
EPPnumberExcess 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).
NonQualDefCompnumberNonqualified 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
Is2ndTINnotBooleanWhen TRUE, indicates the payer was notified by the IRS twice within 3 calendar years of an incorrect TIN and does not want further notices.
AccountNumstringOptional. Account number (used when filing multiple 1099-MISCs for one recipient).
Statesobject[]List of state filing details.
StateCdstring2-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"

StateIdNumstringPayer's state identification number.
StateWHnumberState income tax withheld.
StateIncomenumberState income amount.
Request Params
SampleDescriptionAction
Sample 1
Get with only the SubmissionID
Sample 1
"Form1099MISC/get?submissionId=59a736e5-1ded-4859-8fbb-0a9a592051a5"
Response Json
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
Response: 200
{
"Form1099Records": [
{
"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
}
]
}
}
],
"Errors": null
}