1099-NEC payees of a tax year

Finance module

GET/form-1099-nec/rowsform1099Nec.rows

Payees paid $600 or more in approved USD payments in the calendar year as independent contractors (individuals and accounts), with whether a W-9 and its address are on file. Full TINs are a Restricted export with step-up, in Atlas only. A rule that refuses the request returns 422 with `refusal` and `reason`.

Requires the capability finance.payment.read.
OAuth scopes: finance.
Error statuses: 400, 401, 422, 429. Errors are RFC 9457 problem details.

Path and query parameters

form1099Nec.rows: Path and query parameters
Field	Type	Required	Description
year	integer	Yes	Tax year.Constraints: range 2020 to any

Response 200: Form1099NecRowPage

form1099Nec.rows: Form1099NecRowPage
Field	Type	Required	Description
data	array of Form1099NecRow	Yes	Items on this page, in the documented default order.
next_cursor	string \| null	Yes	Opaque cursor for the next page; null on the last page.

{
  "data": [
    {
      "payee_person_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "payee_organization_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "payee_name": "Ivy Marchetti",
      "w9_on_file": true,
      "tin_type": 2,
      "tin_last4": "6789",
      "address_complete": true,
      "amount_minor": 75000,
      "payment_count": 2
    }
  ],
  "next_cursor": null
}

Code samples

curl -X GET "$XOS_BASE_URL/form-1099-nec/rows" \
  -H "Authorization: Bearer $XOS_API_KEY"

const { data } = await xos.form1099Nec.rows();

response = xos.form1099_nec.rows()

xos form1099-nec rows