Logic API (Beta)

Taxbit's tax documentation rules engine, as an API. You build every screen; Taxbit keeps the tax logic right.

Taxbit's tax documentation rules engine, as an API. You build every screen; Taxbit keeps the tax logic right.

🚧

Beta

The Logic API is live and ready to use. Every Taxbit client can call it today, with no sign-up: the client spec and validation endpoints are in the API reference. The beta label means the shape of its responses may change before general availability.

The Logic API is the engine behind Taxbit's questionnaires, available to call directly. Send it the answers a user has given so far, and it tells you what the form needs now:

  • Which fields to show next, in order, with their labels, options and help text, already translated.
  • Real-time errors and warnings on what's been entered, worded and ready to show.
  • Whether the form is complete, and, when it is, the finished document to submit.

Your team decides how every screen looks and behaves. Taxbit decides what to ask and whether the answers hold up, so you never write or maintain tax rules yourself. When a rule or a question changes, the next response reflects it, with no release on your side.

📘

Is this the right option?

The Logic API is for teams that want to fully own the collection UI and have the engineering resources to build it. If you'd rather use Taxbit's ready-made questionnaire, the React SDK gets you there with one component, and Native Mobile Collection does the same in React Native. See the Tax documentation overview to compare every option.

What it covers

Every questionnaire Taxbit offers:

questionnaireCollects
W-FORM (recommended)Whichever W-form the person needs. The answers decide: W-9, W-8BEN, W-8BEN-E or W-8IMY.
W-9, W-8, W-8BEN, W-8BEN-E, W-8IMYOne W-form, or the W-8 family
SELF-CERTA tax residency self-certification (CARF, DAC8, CRS)
DPSA digital platform seller declaration (DAC7, MRDP)

The same API also handles FATCA and treaty-claim questions, pre-filling from what Taxbit already holds, real-time IRS TIN matching on a W-9, and GIIN checks against the IRS FFI list.

Who does what

YouTaxbit
Build every screen, in any language or frameworkDecides which questions each person sees, based on their answers
Draw each field the response describesWrites every label, option and error message, translated into up to 45 locales (19 for W-forms)
Send the answers back as the user goesChecks each answer, and runs the IRS and FFI checks when the user moves on
Mint a short-lived token for the user on your serverBuilds and signs the finished document
Submit the finished documentStores it and keeps its status up to date for reporting

How it works

sequenceDiagram
    participant UI as Your UI
    participant T as Logic API
    UI->>T: Open: the questionnaire and anything you already know
    T-->>UI: The fields to show, already filled from saved data
    loop As the user answers
        UI->>T: The answers so far
        T-->>UI: Updated fields, errors and warnings
    end
    UI->>T: Submit: the answers, moving on
    T-->>UI: complete: true, and the signed document
    UI->>T: Store the signed document

Each call is stateless: the response depends only on the request. Your UI holds the answers and sends them each time.

Built for coding agents

The Logic API ships with a machine-readable client spec: the protocol your UI must follow, every value a response can carry, real example exchanges, and a conformance script that checks your client by watching the requests it makes. Get the client spec with a tenant token and hand it to your coding agent, and it has everything it needs to build a conforming client in your stack.

Next steps