Create filings

POST /v1/tax/filings

Exports the caller org's return for a tax year and form, as the files the IRIS Taxpayer Portal takes, and records the export. Org admins of the payer only: the files carry TINs in full, so a SuperAdmin acting inside the org is refused here exactly as at the TIN read.

It carries every furnished (or owed) form of that year and kind not already in an earlier export that IRIS did not reject — a rejected submission filed nothing, so its forms go out again as originals. Originals are in one set of files and corrections of forms already exported in another, at most 250 records a file, each written to every rule Pub 5717 §3.5 sets and checked against them before it is answered. The files carry full TINs: the export is on the audit trail and the files are not stored, only rebuilt from the sealed forms when read again.

It DOES NOT FILE WITH THE IRS. Submitting through IRIS needs the payer's own Transmitter Control Code and a person at the portal; the answer lists those steps, and POST /v1/tax/filings/{id}/receipt records what IRIS answered.

Request

2 fields, body application/json (required).

Response

201 body — 19 fields.

Failure carries the platform error shape — see Errors.

Examples

import { Configuration, TaxApi } from 'hanzoai';

const api = new TaxApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.postTaxFilings({ kind: "<kind>", year: 0 });

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import TaxApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = TaxApi(client).post_tax_filings(kind="<kind>", year=0)

cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.TaxAPI.PostTaxFilings(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_client::apis::{configuration::Configuration, tax_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = tax_api::post_tax_filings(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.TaxApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new TaxApi(client).postTaxFilings();

curl -X POST https://api.hanzo.ai/v1/tax/filings \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "kind": "<kind>",
       "year": 0
     }'

Tax API · All Hanzo APIs · Interactive reference