---
title: "Transmit Form 1099-NEC to the IRS"
method: POST
path: "/payout/{user_token}/tax/form1099nec/transmit"
tags: ["Tax"]
---

# Transmit Form 1099-NEC to the IRS

`POST /payout/{user_token}/tax/form1099nec/transmit`

This **POST** endpoint is used to transmit a Form 1099-NEC to the IRS for a specific user identified by their `user_token`. Once transmitted, the form cannot be edited or deleted. If no `submission_id` is provided, the latest untransmitted 1099-NEC form for the user will be transmitted.

## Request body

- Form1099NECTransmitRequest
  - `submission_id` string, uuid — Optional. The submission ID of the 1099-NEC form to transmit. If not provided, the latest untransmitted form for the user will be transmitted.

## Response `200`

OK

- Form1099NECTransmitResponse
  - `submission_id` string, uuid — Unique identifier for the submission
  - `status` 'Transmitted' | 'Error' — Status of the transmission
  - `transmitted_at` string, date-time — Timestamp of transmission
  - `state_returns` Form1099NECTransmitStateReturn[] — State return statuses
    - `state_code` string — State code
    - `status` string — Status of the state return
  - `errors` TaxFormError[] — List of errors (if any)
    - `id` string — Error code
    - `name` string — Field name with the error
    - `message` string — Error description

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found - No untransmitted 1099-NEC form found for this user.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

[API](https://skmtc.net/masspay/apis/masspay-api.md) · [All operations](https://skmtc.net/masspay/apis/masspay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/masspay/masspay-api/versions/c03b61a6a551/schema)