Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB
Tax

Update or Correct Form 1099-NEC

This PUT endpoint is used to update or correct a previously submitted Form 1099-NEC. The system automatically determines whether to perform an Update (if the form has not yet been accepted by the IRS) or a Correction (if the form has already been accepted by the IRS). For corrections, specify correction_type as VOID, RECIPIENT, AMOUNT, or RECIPIENT_AMOUNT.

put/payout/{user_token}/tax/form1099nec

Request body

tax_year'2023' | '2024' | '2025' required

Tax year of the Form 1099-NEC

supplemental_nonemployee_compensationnumber

Box 1: Supplemental Nonemployee compensation amount. When provided, this amount will be added to the total amount of payouts and loads (deducting spendbacks) that were initiated in the tax year Either this or nonemployee_compensation is required

nonemployee_compensationnumber

Box 1: Nonemployee compensation amount. When provided, this will be the total amount reported. Either this or supplemental_nonemployee_compensation is required

is_direct_salesboolean

Box 2: Check if $5,000 or more of consumer products sold for resale

excess_golden_parachutenumber

Box 3: Excess golden parachute payments

federal_tax_withheldnumber

Box 4: Federal income tax withheld

account_numberstring

Account number for reference when multiple 1099-NEC forms are filed for the same recipient

is_postalboolean

When set to true, once the return is transmitted, the 1099-NEC form copy will be mailed to the recipient's address via USPS.

Note: Postal Orders for Foreign Address will not be created.

email_addressstring email

Optional email address to receive the tax form link; if provided, the form link will be sent to this address, and if omitted, no email will be sent.

submission_idstring required

The original submission ID to update or correct

is_voidboolean

Set to true to VOID the original filing (zeros out all amounts). Use this when the form should not have been filed at all.

Example request

{
  "submission_id": "abc123-def456-ghi789"
}

Response

OK

submission_idstring

The new submission ID

record_idstring

The new record ID

operation'UPDATE' | 'CORRECTION'

Whether this was an update (pre-IRS acceptance) or correction (post-IRS acceptance)

original_submission_idstring

The original submission ID that was updated/corrected

status'SUCCESS' | 'FAILURE'

Status of the operation