Glossary

Each entry gives the word these guides use, what it means, and the name the API uses where that differs. The guides use the same words throughout.

Terms

Account

The record that holds an account owner's activity. Transactions attach to accounts. An account owner can have one account or several.

API name: accounts. An account and its account owner are different objects; don't use the words interchangeably.

Account owner

The person or business whose tax data you record: your platform's customer. In US reporting the account owner is the recipient, and in MRDP and DAC7 reporting the seller. Tax documentation attaches to account owners. Collecting tax documentation alone, with the React SDK, needs an account owner but not an account.

API name: account-owners. Also called, and avoided here: user, end customer, client, taxpayer.

Account owner token

A short-lived token for one account owner, which your backend requests with POST /v1/oauth/account-owner-token and passes to the React SDK. Schedule its refresh from expires_in; its lifetime depends on its audience.

Asset type

The kind of asset: crypto, fiat, or precious metal. Assets on /v1/assets take CRYPTO, FIAT, or PRECIOUS_METAL. A transaction's asset.type takes Crypto, Fiat, or Precious Metal. Use one case per field, as the schema shows.

Bearer token

The token your backend requests with POST /v1/oauth/token and sends on every API call. It is scoped to your organization (a tenant-scoped token) and lasts 24 hours.

Cost-basis method

The rule that decides which lots a sale draws from, and so the gains Taxbit reports: HIFO, FIFO, LIFO, LOFO, SPECID, or AUSTRIA. A filer carries a default, and an account or a single transaction can override it.

API name: disposition_method. Avoided here: accounting method, and "disposition method" at first use.

Curing

Fixing an issue on a submitted Form W-8 by submitting evidence. Submitting evidence moves the issue to IN_REVIEW, and a compliance reviewer resolves it.

SDK names: TaxbitCuringDocumentation, needsCuringDocumentation. Avoided here: remediation, which on taxbit.com means B-Notices and corrected filings.

Filer

The legal entity that reports: your platform's filing entity, with its legal name, address, EIN or TIN, and reporting settings. The filer appears as the payer on US forms. An organization can hold several filers, and one is the default.

API names: filers, filer_id. The API's payer_id is the same as filer_id. A filer is never the person completing a Form W-9 or W-8.

Form data

Reporting figures your own systems compute and send, for Taxbit to place on forms, instead of the transactions Taxbit would compute them from.

API name: form-items. At first use the guides say "form data, sent as form items".

Forms W-9 and W-8

The IRS forms an account owner gives you: Form W-9 for US persons, Form W-8BEN for non-US individuals, Form W-8BEN-E for non-US entities, and Form W-8IMY for foreign intermediaries and flow-through entities.

W-FORM is only the SDK's questionnaire value. Avoided here in prose: W8, W9, W-form.

IDs

Each object has two identifiers: your ID, which you send as id, and Taxbit's, taxbit_id, a UUID. Where both exist, say whose ID you mean: "your account ID", "the Taxbit account owner ID". Some webhook events put Taxbit's ID in a field that holds yours in the REST API; Webhook events says whose ID each field holds.

API names: id, taxbit_id, account_id, account_owner_id, alternate_account_id, account_owner_external_id.

Ingest page

The page in the Taxbit Dashboard that takes bulk uploads as CSV and JSONL files and offers each CSV template. See How to Ingest Data. Avoided here: file uploader.

Issue

A problem Taxbit found on submitted tax documentation, with an issue_type and a status of OPEN, IN_REVIEW, or RESOLVED. A warning is an issue type that does not invalidate the form.

Organization

Your Taxbit workspace, with its own credentials, data, and Dashboard users. Your sandbox is its own organization, separate from production.

The API calls an organization a tenant; tenant_id is your Organization ID. Webhooks send organization_id.

Questionnaire

The form the React SDK shows an account owner: W-FORM, DPS, or SELF-CERT, set with the questionnaire prop. "Component" is the word for it in code. Avoided here: interview, widget.

Self-certification

An account owner's tax-residency self-certification: their statement of tax residences, citizenship, and TINs, used for CARF, DAC8, and CRS reporting. The SDK collects it with the SELF-CERT questionnaire.

Field names: account owners use tax_residencies; self-certifications use tax_residences.

Submitted

Saved by Taxbit, and nothing more. A 201 response or the SDK's onSuccess means Taxbit stored the data. Checking follows: data_collection_status, tax_documentation_status, and each issue's status.

Tax documentation

What an account owner gives you: Form W-9 or W-8, a self-certification, or DPS seller data.

API names: tax-documentation-data, tax-documentation-status.

Tax Documentation React SDK

Taxbit's React component for collecting tax documentation in your app. With the tax documentation API, it makes up Taxbit's Tax Documentation product. Older names, avoided here: Digital Documentation SDK, Validation API, Digital W-8/W-9 product, Tax Documentation Tool, Self-Cert SDK.

Tax forms and recipient copies

What Taxbit generates for an account: tax forms in US reporting, such as a 1099, and recipient copies in DAC7 and MRDP reporting. Retrieve them with GET /v1/accounts/{id}/tax-documents. In the Taxbit Dashboard, open the account: its Tax Forms tab lists every generated form by tax year, and the Forms page lists all forms and downloads the set.

Tax lot

A quantity of an asset acquired at one time, with its acquisition date and cost. An account's inventory is its open acquisition lots and their basis.

API name: inventory.

Tax screens in your app

The screens you build in your own app from Taxbit's inventory and gains endpoints. Taxbit supplies the APIs, not a white-label interface. Avoided here: "tax center" as a product name.

Taxbit Support

Taxbit's support team for live integrations, reached through Contacting Taxbit Customer Support in the Help Center. During setup, your implementation manager is your contact. Extra sandbox organizations go through the Tenant Creation Request form.

TIN format validation

A check that a TIN has the right format for its country. It does not match the TIN against government records. EU and other non-US TINs get format checks only.

TIN matching

A check of a name and TIN against IRS records. Real-time TIN matching is POST /v1/validations/us-tin, and the result is in tin_status. Event names such as RTTM_TIN_VALIDATION keep their names. Avoided here: RTT, RTTM, certified TIN, and "TIN validation" for this check.

Transaction

A record of one event on an account, such as a trade, a deposit, a withdrawal, or an income payment.

API name: transactions.

User-provided cost basis

Acquisition dates and costs an account owner gives you for an asset that arrived without a cost basis, attached to the deposit as transfer lots. Austria's User-Basis Stock pool is the same data.

API name: transfer-lots. Avoided here: user-entered.

Validated

Checked by Taxbit after a submission. Validation results appear as data_collection_status, tax_documentation_status, and issues; a submission can be saved without being valid.

VAT validation

A check of a VAT number against VIES. The result is in vat_status. It is a different check from TIN matching.

You

In these guides, you are the platform integrating with Taxbit. Your customers are account owners.

Acronyms

CARF

The Crypto-Asset Reporting Framework, the OECD's rules for reporting crypto-asset activity.

CASP

Crypto-asset service provider: a business that reports its account owners' crypto-asset activity under CARF and DAC8.

CRS

The Common Reporting Standard, the OECD's rules for reporting financial account information.

DAC7

The EU directive that requires digital platforms to report the income their sellers earn. DAC7 is EU law; MRDP is the OECD model.

DAC8

The EU directive that extends reporting to crypto-assets: CARF's counterpart in EU law.

DPS

Digital Platform Seller, the questionnaire and data set for seller details under DAC7 and MRDP.

FDAP

Fixed, determinable, annual, or periodical income: the US-source income paid to foreign persons that Form 1042-S reports.

FIFO

First in, first out: a cost-basis method that sells the oldest lots first.

GIIN

Global Intermediary Identification Number, the IRS identifier for a financial institution.

HIFO

Highest in, first out: a cost-basis method that sells the highest-cost lots first.

KESt

Kapitalertragsteuer, Austria's tax on capital gains and investment income, withheld at source.

LIFO

Last in, first out: a cost-basis method that sells the newest lots first.

LOFO

Lowest in, first out: a cost-basis method that sells the lowest-cost lots first.

MRDP

The Model Rules for Reporting by Platform Operators, the OECD's rules for digital platforms reporting seller income. DAC7 is the EU's version in law.

NFE

Non-financial entity, an entity classification for CARF and CRS self-certifications.

P95

The 95th percentile: 95 percent of measurements fall at or below it.

SEMP

Specified Electronic Money Product. Tag one with is_stablecoin_or_semp when you create the asset.

SLA

Service-level agreement. Timing figures in these guides are observed, not SLAs.

SPECID

Specific lot identification: a cost-basis method in which the sale names the lots it draws from. It can only be set on a transaction.

TIN

Taxpayer identification number.

VIES

The VAT Information Exchange System, the EU's service for checking VAT numbers.