Create a 1099-MISC

POST
/v4/documents/1099-misc

Creates a 1099-MISC document and subsequently kicks off a TIN Verification, if the name and TIN combo has not been used before.

Headers

Idempotency-KeystringOptional

The unique key used to identify a request that has already been processed.

Request

This endpoint expects an object.
filingYearintegerRequired

The filing year associated with this document.

formFieldsobjectRequired

The 1099-MISC form fields.

payeeobjectRequired

The payee of the document.

payerobjectRequired

The payer of the document.

userIdstringOptional

The unique identifier for a single end-user of your application.

Response

OK

createdAtdatetime

The ISO 8601 timestamp when the document was created.

filingYearinteger

The filing year associated with this document.

formFieldsobject
idstring

The unique identifier for an existing document.

payeeobject

The payee of the document.

payeeUrlstring

The URL to the payee’s 1099 document. The Payee’s TIN is masked in this document. The Payer’s TIN is not masked.

payerobject

The payer of the document.

payerUrlstring

The URL to the payer’s 1099 document. Both the Payer’s and Payee’s TINs are not masked in this document.

statusenum
Allowed values: CREATEDFILEDACCEPTEDREJECTED

The status of the 1099 document.
  • CREATED: The document has passed data validation and the PDFs have been generated.
  • FILED: The payee’s TIN has been verified and the 1099 has been filed with the appropriate tax authorities.
  • ACCEPTED: The document has been acknowledged and accepted by the appropriate tax authorities.
  • REJECTED: The document has a TIN verification MISMATCH or has been rejected by one or more tax authories.

correctedByIdstringOptional

The documentId of the corrected 1099 document.

correctedFromIdstringOptional

The documentId of the original 1099 document.

userIdstringOptional

The unique identifier for a single end-user of your application.

voidedByIdstringOptional

The documentId of the voided 1099 document.

voidedFromIdstringOptional

The documentId of the original 1099 document.

Errors