Skip to content
TaxComposer

Bookkeeping API and MCP

From vendor payments to reviewed 1099 candidates

A vendor directory is a starting point, not a final 1099 list. The useful output is a set of candidates with traceable payments, missing-information flags and a person’s reviewed decision.

By TaxComposer · Updated · 2 min read

Scope the business and reporting year first

Choose the payer business and tax year before pulling data. Preserve the accounting company ID and vendor ID alongside the TaxComposer workspace reference. Names alone are unreliable matching keys when a bookkeeper handles several clients.

Record whether the source is a complete year’s payment history or only a partial pull. A partial source should remain visibly incomplete rather than being labeled a final annual total.

Source: TaxComposer API Documentation ↗

Normalize payments without losing their meaning

Retain stable transaction IDs, paid dates, signed decimal amounts, currency, payment method and category. Keep reversals or refunds connected to the original records. Do not count both a bill and the payment settling that bill as two payments.

A reporting flag from accounting software is a review hint. Payment type, recipient classification, tax year and the applicable information-return rules still need review. Use current instructions for thresholds rather than a fixed amount carried over from an older year.

Source: IRS: General Instructions for Certain Information Returns ↗

Review identity and missing information

A missing W-9 can trigger a request workflow after the requester confirms contact permission. A signed W-9 supplies certified recipient details, but its signature does not verify the TIN against IRS records. Keep any separately performed TIN match as its own result.

Preserve the original vendor reference when applying a W-9. Do not merge two recipients simply because their display names look alike. Review any mismatch in legal name, tax classification or payer business.

Source: IRS: Instructions for the Requester of Form W-9 ↗

Prepare only the reviewed records

TaxComposer’s accounting import workflow separates the saved source, the version-bound review and preparation of exact reviewed 1099 drafts. Some actions, including accounting-source W-9 requests, require the verified browser owner rather than an arbitrary API key. Read each operation’s current access contract.

  • POST /v1/accounting/imports — save authorized vendor and payment data.
  • GET /v1/accounting/imports/{id} — review candidates and missing information.
  • PUT /v1/accounting/imports/{id}/review — save the reviewed decisions.
  • POST /v1/accounting/imports/{id}/prepare — create drafts from the exact reviewed source.

Source: TaxComposer API Documentation ↗

Primary sources

Sources checked November 12, 2026. Use the instructions for your reporting year and circumstances.

Your next step

Connect your bookkeeping workflow.

Use the current API contract and discover the tools available to your MCP connection.

API Documentation →Connect with MCP →

TaxComposer is production-ready for IRS IRIS e-filing. Prepare for free and pay $1 per form when you file.