Assentt API reference

Documentation

Base URL https://api.assenttwealth.com/v1. Individuals and companies use it to put Accountant, Finance, and Taxes inside software they already run. Every response is JSON. Amounts in tax results are Canadian dollars.

Quickstart

Create a test key in the console, then confirm the key and run a personal estimate.

curl https://api.assenttwealth.com/v1/me \
  -H "Authorization: Bearer sk_test_…"

curl https://api.assenttwealth.com/v1/taxes/estimates/preview/personal \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: est_2025_on_1" \
  -d '{"province":"ON","year":2025,"income":120000}'

Authentication

Send the key in the Authorization header as Bearer. The console uses your Assentt sign-in. Product calls use a key.

Test keys use the test mode. Live keys use live. A missing or unknown key returns unauthenticated.

Errors

A failed call returns one object. Show message to a person. Branch on code in your client.

{
  "error": {
    "code": "invalid-argument",
    "message": "Choose a Canadian province or territory."
  }
}

Idempotency

Send Idempotency-Key on writes. The same key replays the first response for 24 hours, including the original status. A replay includes Idempotent-Replayed: true. Reads ignore the header. Use a new key when the request itself is new.

Rate limits

Each key has its own limit. When you pass it, the call returns resource-exhausted and the message “Too many requests. Try again in a minute.” Successful and failed product calls both count.

Every product response includes X-Assentt-Request-Id. Keep it when you ask Assentt about a call.

Permissions

A secret key carries the permissions for its mode. A restricted key only carries the ones you set.

The public catalog is GET https://api.assenttwealth.com/v1/scopes. It needs no key.

Core

curl https://api.assenttwealth.com/v1/me \
  -H "Authorization: Bearer sk_test_…"

curl "https://api.assenttwealth.com/v1/usage?limit=20" \
  -H "Authorization: Bearer sk_test_…"

curl https://api.assenttwealth.com/v1/plans

curl https://api.assenttwealth.com/v1/health

Accountant

curl https://api.assenttwealth.com/v1/accountant/summary \
  -H "Authorization: Bearer sk_live_…"

Finance

Spending, cash flow, and categorized transactions. Permission finance.transactions:read. This surface opens with Assentt Finance. Until then a call returns failed-precondition.

Taxes

Estimates and organizers for individuals and companies. Money fields are numbers in dollars, not cents.

curl "https://api.assenttwealth.com/v1/taxes/estimates?taxYear=2025" \
  -H "Authorization: Bearer sk_test_…"

curl https://api.assenttwealth.com/v1/taxes/estimates/personal \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: est_2025_on_1" \
  -d '{
    "province": "ON",
    "year": 2025,
    "income": 120000,
    "rrspDeduction": 5000,
    "selfEmployed": false
  }'

curl https://api.assenttwealth.com/v1/taxes/estimates/corporate \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: corp_2025_on_1" \
  -d '{"province":"ON","year":2025,"activeIncome":400000}'

curl https://api.assenttwealth.com/v1/taxes/estimates/preview/corporate \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"province":"BC","activeIncome":250000,"limitShare":0.5}'

curl https://api.assenttwealth.com/v1/taxes/organizers \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: org_2025_1" \
  -d '{"taxYear":2025,"template":"personal","send":false}'

AGI

Next The next AI in this field. One intelligence across Accountant, Finance, and Taxes, called from the software you already run. Permission ai.chat:write. Prices are listed below and apply when the product opens.

Credits

Product calls draw from a prepaid balance in Canadian cents. Add $20.00, $50.00, $100.00, $250.00 in the console. The balance updates when the payment is confirmed. A call that cannot be paid returns failed-precondition.

Prices

Webhooks

curl https://api.assenttwealth.com/v1/webhook_endpoints \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/assentt","events":["usage.recorded"]}'

OpenAPI

Machine-readable spec: https://api.assenttwealth.com/v1/openapi.json. Import it into your client. This page is the guide for how each call behaves.

Plans and engagement