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

# Transmit Form 1099-MISC to the IRS

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

## Request

- Base URL: `https://api.masspay.io/v1.0.0`
- URL: `https://api.masspay.io/v1.0.0/payout/{user_token}/tax/form1099misc/transmit`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/masspay/apis/masspay-api/docs/payout/:user_token/tax/form1099misc/transmit/post.ts> (a function with typed inputs; its response is checked against the schema)

This **POST** endpoint is used to transmit a Form 1099-MISC 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-MISC form for the user will be transmitted.

## Request body

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

## Response `200`

OK

- Form1099MISCTransmitResponse
  - `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-MISC form found for this user.
- `405`: Method Not Allowed.
- `500`: Internal server error.
- `504`: Gateway Time-out.

## Changes

- **2026-11-03** `f9fa41b7c45c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/masspay/apis/masspay-api/changes/payout/:user_token/tax/form1099misc/transmit/post.md)

---

[API](https://skmtc.dev/masspay/apis/masspay-api.md) - [All operations](https://skmtc.dev/masspay/apis/masspay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/masspay/apis/masspay-api/revisions/f9fa41b7c45c?raw)