TaxForms

Create a tax form

Simulates the creation of a tax form for an entity. This allows you to test the tax form workflow including filing statuses, mailing, and webhook events. The normal 7 calendar days grace period for filing will be ignored in simulations.

post/simulate/tax-forms

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/simulate/tax-forms
  • Auth: HTTP basic

Request body

entity_idstring required

The entity ID to create the tax form for

tax_yearinteger required

The tax year for the form

typestring required

The type of tax form to create

Response

Successful response

commentstring nullable

Optional comment about the tax form (e.g., cancellation reason)

created_atstring date-time required

ISO 8601 timestamp when the tax form was created

currency_codestring required

The three-letter currency code defined in ISO 4217. e.g. USD.

descriptionstring nullable

Optional description of the tax form

document_idstring required

ID of the document containing PDF or Zip file of this tax form

entity_idstring required

ID of the entity this tax form belongs to

fed_accepted_atstring date-time nullable

ISO 8601 timestamp when the IRS accepted the form

fed_rejected_atstring date-time nullable

ISO 8601 timestamp when the IRS rejected the form

fed_sent_atstring date-time nullable

ISO 8601 timestamp when the form was sent to the IRS

fed_statusstring required

Status of federal filing. Possible values: not_required, scheduled, sent, accepted, rejected, accepted_with_error, canceled.

gross_amountinteger required

Gross amount in the smallest unit of currency_code (e.g., cents in USD ).

idstring required

Unique ID for the tax form

mail_received_atstring date-time nullable

ISO 8601 timestamp when the mail was received (if tracking available)

mail_sent_atstring date-time nullable

ISO 8601 timestamp when the form was sent via mail

mail_statusstring required

Status of physical mailing to the taxpayer. Possible values: not_required, scheduled, sent, received, canceled.

statestring nullable

State code (e.g., CA) if state filing is required

state_accepted_atstring date-time nullable

ISO 8601 timestamp when the state accepted the form

state_rejected_atstring date-time nullable

ISO 8601 timestamp when the state rejected the form

state_sent_atstring date-time nullable

ISO 8601 timestamp when the form was sent to the state

state_statusstring required

Status of state filing. Possible values: not_required, scheduled, sent, accepted, rejected, canceled.

tax_yearinteger required

The tax year this form covers (e.g., 2025)

typestring required

Type of tax form. Possible types are: 1099_int (IRS 1099-INT form for interest income).

updated_atstring date-time required

ISO 8601 timestamp when the tax form was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.