List payments

GET /v1/tax/payments

Returns the caller org's tax year as a PAYER: every payment it made to another org in that calendar year, on any rail, as the event plane records it, each classified — reportable or not, in which 1099 box, and the rule that decided it, with its source — and each payee's totals tested against the year's threshold.

The rules applied: a payment settled by a card or a third-party settlement network is reported on Form 1099-K by the settlement entity, not here; a payment for merchandise is not reported; a payment to a corporation is generally not reported, except for legal services; a payment in a digital asset is reported at its fair market value on the date paid; a box is reported only at or above the year's threshold — $600 through 2025,$2,000 for 2026 under P.L. 119-21, and not guessed for a year the IRS has not yet published. A payee's classification comes only from a W-9 it granted the caller; without one, nothing establishes an exemption.

Org admins only. It reads; it prepares nothing and files nothing.

Request

1 field.

Response

200 body — 35 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.getTaxPayments();

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).get_tax_payments()

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

resp, _, err := client.TaxAPI.GetTaxPayments(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::get_tax_payments(&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).getTaxPayments();

curl https://api.hanzo.ai/v1/tax/payments \
  -H "Authorization: Bearer $HANZO_API_KEY"

Tax API · All Hanzo APIs · Interactive reference