TaxBridge AI API V1

Read and evaluate integration guide

The first API release supports schema retrieval, assessment evaluation and read-only workspace/task access. It does not expose write operations.

Manage API KeysAll Tools

Authentication

Send the complete key in the X-TaxBridge-API-Key header. Keys are displayed once and stored by TaxBridge only as hashes.

curl -H "X-TaxBridge-API-Key: tbk_test_..." \
  https://your-backend.example/api/v1/taxbridge/schema

Endpoints

GETassessment:read

/api/v1/taxbridge/schema

Retrieve the current versioned assessment schema.

POSTassessment:evaluate

/api/v1/taxbridge/evaluate

Evaluate a structured preparation payload using the governed rules engine.

GETworkspaces:read

/api/v1/taxbridge/workspaces

List active workspaces accessible to the API-key owner.

GETtasks:read

/api/v1/taxbridge/workspaces/{workspaceId}/tasks

List preparation tasks in an accessible or key-restricted workspace.

Evaluation example

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-TaxBridge-API-Key: tbk_test_..." \
  -d '{"businessCountry":"Finland","customerCountries":["Nigeria"],"businessType":"digital_services"}' \
  https://your-backend.example/api/v1/taxbridge/evaluate

Security and product boundary

  • Use one key per integration and revoke unused keys immediately.
  • Restrict a key to one workspace where possible.
  • TaxBridge usage logs store endpoint, method and status—not request bodies.
  • API output is compliance preparation and does not replace regulated professional advice.