52 KiB
\TaxAPI
All URIs are relative to https://api.hanzo.ai
| Method | HTTP request | Description |
|---|---|---|
| GetTaxFilings | Get /v1/tax/filings | Lists the caller org's IRS return exports and where each stands, without their files. |
| GetTaxFilingsById | Get /v1/tax/filings/{id} | Reads one IRS return export WITH its files, rebuilt from the sealed forms and proven identical to what was exported. |
| GetTaxForms | Get /v1/tax/forms | Lists the 1099s the caller org prepared as payer, oldest first, voided and superseded ones included — a return that was furnished stays on the record. |
| GetTaxFormsById | Get /v1/tax/forms/{id} | Reads one 1099 the caller org prepared as payer, every box and both parties, TINs masked. |
| GetTaxFormsByIdPdf | Get /v1/tax/forms/{id}/pdf | Download a 1099 the org prepared, as a PDF |
| GetTaxInbox | Get /v1/tax/inbox | Lists the Copy B statements furnished to the caller org — every 1099 a payer on Hanzo delivered to it electronically, corrected ones beside the ones they supersede. |
| GetTaxInboxById | Get /v1/tax/inbox/{id} | Reads one Copy B furnished to the caller org. |
| GetTaxInboxByIdPdf | Get /v1/tax/inbox/{id}/pdf | Download a Copy B furnished to the org, as a PDF |
| GetTaxPayments | 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. |
| GetTaxProfile | Get /v1/tax/profile | Returns the caller org's own tax profile — every line of its Form W-9, W-8BEN or W-8BEN-E, every number masked to its last four characters, where the certification stands, whether a W-8 is valid and when it expires, and whether the org consents to receive its 1099s electronically. |
| GetTaxW9 | Get /v1/tax/w9 | Lists the caller org's W-9 relationships on both sides: the W-9s it asked its payees for, with where each stands, and the requests other orgs made for its own W-9. |
| GetTaxW9ById | Get /v1/tax/w9/{id} | Reads one W-9 relationship from the caller's side. |
| GetTaxW9ByIdTin | Get /v1/tax/w9/{id}/tin | Reads a payee's TIN in full — and, for a payee on a W-8, its foreign TIN, which the payer's Form 1042-S carries. |
| PostTaxFilings | 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. |
| PostTaxFilingsByIdReceipt | Post /v1/tax/filings/{id}/receipt | Records what IRIS answered for an exported return — the Receipt ID on submission, then the acknowledgment. |
| PostTaxForms | Post /v1/tax/forms | Prepares the caller org's 1099 drafts for a tax year, as the PAYER: one 1099-NEC and/or 1099-MISC per payee whose reportable payments on Hanzo's rails reach the year's threshold, from the same derivation GET /v1/tax/payments answers. |
| PostTaxFormsByIdCorrect | Post /v1/tax/forms/{id}/correct | Corrects a furnished (or owed) 1099 with a NEW form that supersedes it. |
| PostTaxFormsByIdFurnish | Post /v1/tax/forms/{id}/furnish | Furnishes Copy B of a reviewed 1099 to its payee. |
| PostTaxFormsByIdMailed | Post /v1/tax/forms/{id}/mailed | Records that the payer mailed a paper Copy B it owed. |
| PostTaxFormsByIdReview | Post /v1/tax/forms/{id}/review | Marks a draft 1099 reviewed — a person has checked it. |
| PostTaxFormsByIdVoid | Post /v1/tax/forms/{id}/void | Voids a draft or reviewed 1099, which is then never furnished or filed. |
| PostTaxProfileCertify | Post /v1/tax/profile/certify | Signs the caller org's certification — Form W-9 Part II, Form W-8BEN Part III or Form W-8BEN-E Part XXX — through /v1/legal's e-signature. |
| PostTaxW9 | Post /v1/tax/w9 | Asks another org for its W-9, as the org that pays it. |
| PostTaxW9ByIdDecline | Post /v1/tax/w9/{id}/decline | Declines a request for this org's W-9. |
| PostTaxW9ByIdGrant | Post /v1/tax/w9/{id}/grant | Grants the payer that asked a live read of this org's W-9 — every line, the TIN masked, and the full TIN to that payer's org admins alone, each read audited. |
| PostTaxW9ByIdMatch | Post /v1/tax/w9/{id}/match | Records the result of IRS TIN Matching for a payee, as the payer. |
| PostTaxW9ByIdRevoke | Post /v1/tax/w9/{id}/revoke | Revokes a W-9 this org granted. |
| PutTaxProfile | Put /v1/tax/profile | Writes the caller org's tax profile — its Form W-9, or its Form W-8BEN or W-8BEN-E when it is a foreign person — and answers it, every number masked. |
GetTaxFilings
TaxFilingList GetTaxFilings(ctx).Execute()
Lists the caller org's IRS return exports and where each stands, without their files.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxFilings(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxFilings``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxFilings`: TaxFilingList
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxFilings`: %v\n", resp)
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxFilingsRequest struct via the builder pattern
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxFilingsById
TaxFiling GetTaxFilingsById(ctx, id).Execute()
Reads one IRS return export WITH its files, rebuilt from the sealed forms and proven identical to what was exported.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the filing id, \"iris_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxFilingsById(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxFilingsById``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxFilingsById`: TaxFiling
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxFilingsById`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the filing id, "iris_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxFilingsByIdRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxForms
TaxFormList GetTaxForms(ctx).Year(year).Execute()
Lists the 1099s the caller org prepared as payer, oldest first, voided and superseded ones included — a return that was furnished stays on the record.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
year := int64(789) // int64 | Year narrows the list to one tax year; absent lists every year. (optional)
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxForms(context.Background()).Year(year).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxForms``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxForms`: TaxFormList
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxForms`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxFormsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| year | int64 | Year narrows the list to one tax year; absent lists every year. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxFormsById
TaxForm GetTaxFormsById(ctx, id).Execute()
Reads one 1099 the caller org prepared as payer, every box and both parties, TINs masked.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxFormsById(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxFormsById``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxFormsById`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxFormsById`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxFormsByIdRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxFormsByIdPdf
GetTaxFormsByIdPdf(ctx, id).Execute()
Download a 1099 the org prepared, as a PDF
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.TaxAPI.GetTaxFormsByIdPdf(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxFormsByIdPdf``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxFormsByIdPdfRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxInbox
TaxStatementList GetTaxInbox(ctx).Year(year).Execute()
Lists the Copy B statements furnished to the caller org — every 1099 a payer on Hanzo delivered to it electronically, corrected ones beside the ones they supersede.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
year := int64(789) // int64 | Year narrows the list to one tax year; absent lists every year. (optional)
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxInbox(context.Background()).Year(year).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxInbox``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxInbox`: TaxStatementList
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxInbox`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxInboxRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| year | int64 | Year narrows the list to one tax year; absent lists every year. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxInboxById
TaxStatement GetTaxInboxById(ctx, id).Execute()
Reads one Copy B furnished to the caller org.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxInboxById(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxInboxById``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxInboxById`: TaxStatement
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxInboxById`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxInboxByIdRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxInboxByIdPdf
GetTaxInboxByIdPdf(ctx, id).Execute()
Download a Copy B furnished to the org, as a PDF
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.TaxAPI.GetTaxInboxByIdPdf(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxInboxByIdPdf``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxInboxByIdPdfRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxPayments
TaxLedger GetTaxPayments(ctx).Year(year).Execute()
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.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
year := int64(789) // int64 | Year is the calendar year the payments were made in, e.g. 2026. (optional)
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxPayments(context.Background()).Year(year).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxPayments``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxPayments`: TaxLedger
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxPayments`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxPaymentsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| year | int64 | Year is the calendar year the payments were made in, e.g. 2026. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxProfile
TaxProfile GetTaxProfile(ctx).Execute()
Returns the caller org's own tax profile — every line of its Form W-9, W-8BEN or W-8BEN-E, every number masked to its last four characters, where the certification stands, whether a W-8 is valid and when it expires, and whether the org consents to receive its 1099s electronically.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxProfile(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxProfile``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxProfile`: TaxProfile
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxProfile`: %v\n", resp)
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxProfileRequest struct via the builder pattern
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxW9
TaxW9List GetTaxW9(ctx).Execute()
Lists the caller org's W-9 relationships on both sides: the W-9s it asked its payees for, with where each stands, and the requests other orgs made for its own W-9.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxW9(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxW9``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxW9`: TaxW9List
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxW9`: %v\n", resp)
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxW9Request struct via the builder pattern
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxW9ById
TaxW9 GetTaxW9ById(ctx, id).Execute()
Reads one W-9 relationship from the caller's side.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship's id, \"w9_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxW9ById(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxW9ById``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxW9ById`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxW9ById`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship's id, "w9_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxW9ByIdRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTaxW9ByIdTin
TaxTinOut GetTaxW9ByIdTin(ctx, id).Execute()
Reads a payee's TIN in full — and, for a payee on a W-8, its foreign TIN, which the payer's Form 1042-S carries.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship's id, \"w9_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.GetTaxW9ByIdTin(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.GetTaxW9ByIdTin``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetTaxW9ByIdTin`: TaxTinOut
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.GetTaxW9ByIdTin`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship's id, "w9_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiGetTaxW9ByIdTinRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFilings
TaxFiling PostTaxFilings(ctx).TaxExportIn(taxExportIn).Execute()
Exports the caller org's return for a tax year and form, as the files the IRIS Taxpayer Portal takes, and records the export.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
taxExportIn := *openapiclient.NewTaxExportIn() // TaxExportIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFilings(context.Background()).TaxExportIn(taxExportIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFilings``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFilings`: TaxFiling
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFilings`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFilingsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| taxExportIn | TaxExportIn |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFilingsByIdReceipt
TaxFiling PostTaxFilingsByIdReceipt(ctx, id).TaxReceiptIn(taxReceiptIn).Execute()
Records what IRIS answered for an exported return — the Receipt ID on submission, then the acknowledgment.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the filing, from the path.
taxReceiptIn := *openapiclient.NewTaxReceiptIn() // TaxReceiptIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFilingsByIdReceipt(context.Background(), id).TaxReceiptIn(taxReceiptIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFilingsByIdReceipt``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFilingsByIdReceipt`: TaxFiling
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFilingsByIdReceipt`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the filing, from the path. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFilingsByIdReceiptRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
taxReceiptIn | TaxReceiptIn | |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxForms
TaxPrepared PostTaxForms(ctx).TaxPrepareIn(taxPrepareIn).Execute()
Prepares the caller org's 1099 drafts for a tax year, as the PAYER: one 1099-NEC and/or 1099-MISC per payee whose reportable payments on Hanzo's rails reach the year's threshold, from the same derivation GET /v1/tax/payments answers.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
taxPrepareIn := *openapiclient.NewTaxPrepareIn() // TaxPrepareIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxForms(context.Background()).TaxPrepareIn(taxPrepareIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxForms``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxForms`: TaxPrepared
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxForms`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| taxPrepareIn | TaxPrepareIn |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFormsByIdCorrect
TaxForm PostTaxFormsByIdCorrect(ctx, id).TaxCorrectIn(taxCorrectIn).Execute()
Corrects a furnished (or owed) 1099 with a NEW form that supersedes it.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the furnished form to correct, from the path.
taxCorrectIn := *openapiclient.NewTaxCorrectIn() // TaxCorrectIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFormsByIdCorrect(context.Background(), id).TaxCorrectIn(taxCorrectIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFormsByIdCorrect``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFormsByIdCorrect`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFormsByIdCorrect`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the furnished form to correct, from the path. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsByIdCorrectRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
taxCorrectIn | TaxCorrectIn | |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFormsByIdFurnish
TaxForm PostTaxFormsByIdFurnish(ctx, id).Execute()
Furnishes Copy B of a reviewed 1099 to its payee.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFormsByIdFurnish(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFormsByIdFurnish``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFormsByIdFurnish`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFormsByIdFurnish`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsByIdFurnishRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFormsByIdMailed
TaxForm PostTaxFormsByIdMailed(ctx, id).Execute()
Records that the payer mailed a paper Copy B it owed.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFormsByIdMailed(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFormsByIdMailed``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFormsByIdMailed`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFormsByIdMailed`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsByIdMailedRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFormsByIdReview
TaxForm PostTaxFormsByIdReview(ctx, id).Execute()
Marks a draft 1099 reviewed — a person has checked it.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFormsByIdReview(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFormsByIdReview``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFormsByIdReview`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFormsByIdReview`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsByIdReviewRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxFormsByIdVoid
TaxForm PostTaxFormsByIdVoid(ctx, id).Execute()
Voids a draft or reviewed 1099, which is then never furnished or filed.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the form id, \"f1099_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxFormsByIdVoid(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxFormsByIdVoid``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxFormsByIdVoid`: TaxForm
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxFormsByIdVoid`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the form id, "f1099_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxFormsByIdVoidRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxProfileCertify
TaxProfile PostTaxProfileCertify(ctx).Execute()
Signs the caller org's certification — Form W-9 Part II, Form W-8BEN Part III or Form W-8BEN-E Part XXX — through /v1/legal's e-signature.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxProfileCertify(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxProfileCertify``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxProfileCertify`: TaxProfile
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxProfileCertify`: %v\n", resp)
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxProfileCertifyRequest struct via the builder pattern
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxW9
TaxW9 PostTaxW9(ctx).TaxW9Request(taxW9Request).Execute()
Asks another org for its W-9, as the org that pays it.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
taxW9Request := *openapiclient.NewTaxW9Request() // TaxW9Request |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxW9(context.Background()).TaxW9Request(taxW9Request).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxW9``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxW9`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxW9`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxW9Request struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| taxW9Request | TaxW9Request |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxW9ByIdDecline
TaxW9 PostTaxW9ByIdDecline(ctx, id).Execute()
Declines a request for this org's W-9.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship's id, \"w9_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxW9ByIdDecline(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxW9ByIdDecline``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxW9ByIdDecline`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxW9ByIdDecline`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship's id, "w9_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxW9ByIdDeclineRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxW9ByIdGrant
TaxW9 PostTaxW9ByIdGrant(ctx, id).Execute()
Grants the payer that asked a live read of this org's W-9 — every line, the TIN masked, and the full TIN to that payer's org admins alone, each read audited.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship's id, \"w9_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxW9ByIdGrant(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxW9ByIdGrant``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxW9ByIdGrant`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxW9ByIdGrant`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship's id, "w9_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxW9ByIdGrantRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxW9ByIdMatch
TaxW9 PostTaxW9ByIdMatch(ctx, id).TaxMatchIn(taxMatchIn).Execute()
Records the result of IRS TIN Matching for a payee, as the payer.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship, from the path.
taxMatchIn := *openapiclient.NewTaxMatchIn() // TaxMatchIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxW9ByIdMatch(context.Background(), id).TaxMatchIn(taxMatchIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxW9ByIdMatch``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxW9ByIdMatch`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxW9ByIdMatch`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship, from the path. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxW9ByIdMatchRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
taxMatchIn | TaxMatchIn | |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostTaxW9ByIdRevoke
TaxW9 PostTaxW9ByIdRevoke(ctx, id).Execute()
Revokes a W-9 this org granted.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
id := "id_example" // string | ID is the relationship's id, \"w9_\"-prefixed.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PostTaxW9ByIdRevoke(context.Background(), id).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PostTaxW9ByIdRevoke``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostTaxW9ByIdRevoke`: TaxW9
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PostTaxW9ByIdRevoke`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| id | string | ID is the relationship's id, "w9_"-prefixed. |
Other Parameters
Other parameters are passed through a pointer to a apiPostTaxW9ByIdRevokeRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PutTaxProfile
TaxProfile PutTaxProfile(ctx).TaxProfileIn(taxProfileIn).Execute()
Writes the caller org's tax profile — its Form W-9, or its Form W-8BEN or W-8BEN-E when it is a foreign person — and answers it, every number masked.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
taxProfileIn := *openapiclient.NewTaxProfileIn() // TaxProfileIn |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.TaxAPI.PutTaxProfile(context.Background()).TaxProfileIn(taxProfileIn).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `TaxAPI.PutTaxProfile``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PutTaxProfile`: TaxProfile
fmt.Fprintf(os.Stdout, "Response from `TaxAPI.PutTaxProfile`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiPutTaxProfileRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| taxProfileIn | TaxProfileIn |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]