API Reference1099-NEC

Correct a 1099-NEC

Files a new corrected 1099-NEC and relates it to the original document. A 1099-NEC can be corrected only after it has reached the FILED status. Automatically handles both one-transaction and two-transaction corrections.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

documentIdstringRequired
The unique identifier for an existing document.

Headers

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

Request

This endpoint expects an object.
formFieldsobjectRequired

The 1099-NEC form fields.

payeeobjectRequired
The payee of the document.
userIdstringOptional

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

Response

This endpoint returns an object.
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
The status of the 1099 document.<br/>&nbsp;&nbsp;• `CREATED`: The document has passed data validation and the PDFs have been generated.<br/>&nbsp;&nbsp;• `FILED`: The payee's TIN has been verified and the 1099 has been filed with the appropriate tax authorities.<br/>&nbsp;&nbsp;• `ACCEPTED`: The document has been acknowledged and accepted by the appropriate tax authorities.<br/>&nbsp;&nbsp;• `REJECTED`: The document has a TIN verification `MISMATCH` or has been rejected by one or more tax authories.
Allowed values:
correctedByIdstring or null

The documentId of the corrected 1099 document.

correctedFromIdstring or null

The documentId of the original 1099 document.

userIdstring or null

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

voidedByIdstring or null

The documentId of the voided 1099 document.

voidedFromIdstring or null

The documentId of the original 1099 document.

Errors