Transmit

Transmit

This endpoint can be used to transmit Form ACA returns to the federal and/or state agencies.

Key points

• Call this endpoint only after all validation errors are resolved. If errors exist, review and correct them before transmitting.
• To transmit all returns under a submission, provide only the SubmissionId in the request.
• Once a form is transmitted, it cannot be edited or deleted.

POST acaform\transmit 

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	A unique identifier of a submission.

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of the submission containing the transmitted record.
FormACARecords	object[]	Returns the transmitted Form ACA records along with their federal, state, and distribution statuses.
FormType	string	Denotes the type of tax form that was transmitted
RecordId	Guid	Unique identifier generated for the transmitted tax form record.
FederalStatus	object	Returns the federal transmission status of the record.
StatusCd	string	Status code representing the federal transmission status.
Status	string	Current status of the federal transmission (for example, TRANSMITTED, ACCEPTED, REJECTED).
Info	string	Additional information related to the federal transmission status. Returns null if no additional information is available.
StatusTs	string	Date and time when the federal transmission status was last updated.
StatesStatus	object[]	Returns a collection of state transmission status information.
StateCd	string	Two-letter state abbreviation for which the return was transmitted.
StatusCd	string	Status code representing the state transmission status.
Status	string	Current transmission status for the specified state.
Info	string	Additional information related to the state transmission status. Returns null if no additional information is available.
StatusTs	string	Date and time when the state transmission status was last updated.
Distribution	object	Returns information about the recipient distribution service.
DistributionType	string	Specifies the distribution method selected for the recipient copy (for example, POSTAL_AND_ONLINE, POSTAL_ONLY, or ONLINE_ONLY).
PostalStatus	object	Returns the postal mailing status information.
PostalType	string	Specifies the postal delivery service selected for mailing the recipient copy (for example, USPS_FIRST_CLASS).
Code	string	Status code representing the postal distribution status.
Status	string	Current status of the postal distribution (for example, ORDER_CREATED, IN_TRANSIT, DELIVERED).
Info	string	Additional information related to the postal distribution status. Returns null if no additional information is available.
StatusTs	string	Date and time when the postal distribution status was last updated.
OnlineAccessStatus	object	Returns the online access status information for the recipient.
Email	string	Email address to which online access has been provided.
Code	string	Status code representing the online access status.
Status	string	Current online access status (for example, ORDER_CREATED, EMAIL_SENT, or VIEWED_FORM).
Info	string	Additional information related to the online access status. Returns null if no additional information is available.
StatusTs	string	Date and time when the online access status was last updated.
CreatedTs	string	Date and time when the form was last created.
LastUpdatedTs	string	Date and time when the form was last updated.

Payload

Request Json

Sample	Description	Action
Sample 1	Transmit Form ACA returns using SubmissionId and RecordIds.

Sample 1

{
  "SubmissionId": "4fc3dc91-64fe-4877-9193-7c520c21896a",
  "RecordIds": [
    "53eb195d-4914-4a14-9348-251a55909c1d"
  ]
}

Response JSON

Response	Description	Action
200	Success Response - You'll get the below response when the request is processed successfully.
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.

Response: 200

{
  "SubmissionId": "4fc3dc91-64fe-4877-9193-7c520c21896a",
  "FormACARecord": {
    "RecordId": "53eb195d-4914-4a14-9348-251a55909c1d",
    "FormType": "Form1095B",
    "FederalStatus": {
      "StatusCd": "FED-002",
      "Status": "TRANSMITTED",
      "Info": null,
      "StatusTs": "2026-08-24T06:37:31-04:00"
    },
    "StatesStatus": [
      {
        "StateCd": "MA",
        "StatusCd": "ST-002",
        "Status": "TRANSMITTED",
        "Info": null,
        "StatusTs": "2026-08-24T06:37:31-04:00"
      }
    ],
    "Distribution": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalStatus": {
        "PostalType": "USPS_FIRST_CLASS",
        "Code": "POS-002",
        "Status": "ORDER_RECEIVED",
        "Info": "Handed off to USPS",
        "StatusTs": "2026-08-24T06:22:00-04:00"
      },
      "OnlineAccessStatus": {
        "Email": "david.thompson@sample.com",
        "Code": "OA-003",
        "Status": "ORDER_RECEIVED",
        "Info": "Notification email sent",
        "StatusTs": "2026-08-24T06:22:00-04:00"
      }
    },
    "CreatedTs": "2026-08-24T06:14:51-04:00",
    "LastUpdatedTs": "2026-08-24T06:37:31-04:00"
  },
  "Errors": null
}