v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB

Tax

Submit Form 1099-NEC

This POST endpoint is used to submit a Form 1099-NEC (Nonemployee Compensation) for a specific user identified by their user_token. The 1099-NEC form is used to report nonemployee compensation of $600 or more. Basic information (name, address, email, phone, TIN) is retrieved from the user's existing profile.

post/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.

Response

submission_idstring uuid

Unique identifier for the submission

form_type'1099-NEC'

Type of form submitted

tax_yearstring

Tax year of the submission

status'Created' | 'Pending' | 'Validated' | 'Error'

Current status of the submission

submitted_atstring date-time

Timestamp of submission

pdf_contentstring

Base64 encoded byte representing the content of the file

gross_amountnumber

Total gross amount reported. This amount includes the total payouts through MassPay in addition to the supplemental gross amount provided.