API DOCUMENTATION

Sandbox

Build against deterministic scenarios with no path to a government system.

GET /v1/sandbox/scenarios lists named scenarios for every program and every outcome. POST /v1/sandbox/scenarios/{id}/run runs one exactly as POST /v1/tax/calculations would: a real calculation record, a calculation.completed event to every sandbox endpoint, a line in the trace. Sandbox keys only.

ScenarioProgramExpect
ca-t1-employee-on — Ontario employee with one T4 and an RRSP deductionCA/T1 2026IN_SCOPE
ca-t1-self-employed-bc — British Columbia sole proprietorCA/T1 2026IN_SCOPE
ca-t1-no-province — Personal return with the province missingCA/T1 2026INCOMPLETE
curl -X POST https://api.taxpio.com/v1/sandbox/scenarios/ca-t1-employee-on/run \
  -H "Authorization: Bearer tp_test_…"