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.
BetaThe 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:
questionnaire | Collects |
|---|---|
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-8IMY | One W-form, or the W-8 family |
SELF-CERT | A tax residency self-certification (CARF, DAC8, CRS) |
DPS | A 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
| You | Taxbit |
|---|---|
| Build every screen, in any language or framework | Decides which questions each person sees, based on their answers |
| Draw each field the response describes | Writes every label, option and error message, translated into up to 45 locales (19 for W-forms) |
| Send the answers back as the user goes | Checks each answer, and runs the IRS and FFI checks when the user moves on |
| Mint a short-lived token for the user on your server | Builds and signs the finished document |
| Submit the finished document | Stores 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
- Walkthrough: one W-9, request by request
- Developer guide: authentication, settings, the request cycle, errors and submitting
- API reference: Validate tax documentation · Get the client spec
Updated 36 minutes ago
