Saltar al contenido

1099-NEC payees of a tax year

Módulo Finance

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`.

  • Requiere la capacidad finance.payment.read.
  • Alcances de OAuth: finance.
  • Estados de error: 400, 401, 422, 429. Los errores son detalles de problema RFC 9457.

Parámetros de ruta y de consulta

form1099Nec.rows: Parámetros de ruta y de consulta
CampoTipoObligatorioDescripción
yearintegerSíTax year.Restricciones: range 2020 to any

Respuesta 200: Form1099NecRowPage

form1099Nec.rows: Form1099NecRowPage
CampoTipoObligatorioDescripción
dataarray of Form1099NecRowSíItems on this page, in the documented default order.
next_cursorstring | nullSí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
}

Ejemplos de código

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