Avalara AvaTax vs Numeral

Avalara AvaTax

The REST API has a public Swagger file with 491 operations, a Markdown page per endpoint and a 90-day trial with no card. Production rate limits and prices per transaction are not published, the API patch notes stop at April 2023, and the tax calculation service was degraded for about 23 hours on 5 and 6 October 2026.

Numeral

Docs are written for agents, with a public OpenAPI spec for 32 operations, Markdown pages, llms.txt and a remote MCP server whose 14 tools are read-only by default. No status page, numeric rate limit or SLA was found, the API ignores idempotency keys, and API access is sold on a custom plan after a demo.

Avalara AvaTax

1. Omit type or send SalesOrder for an estimate. A type ending in Invoice is recorded, and commit set to true locks it for reporting
2. Retry a timed-out invoice with CreateOrAdjustTransaction, not CreateTransaction, which errors when a committed transaction has the same code
3. Use sandbox-rest.avatax.com with sandbox credentials for tests. Production is rest.avatax.com and the two accounts are separate
4. Add $include=SummaryOnly or LinesOnly to shrink transaction responses, and page lists with $top (1,000 at most) and $skip
5. Call /api/v2/utilities/ping first. It answers without credentials and shows whether the credentials sent were accepted

Numeral

1. Send X-API-Version: 2026-03-01 on every call to https://api.numeralhq.com. Merchant, platform and certificate endpoints reject requests without it
2. Commit with a stable reference_order_id. On REFERENCE_ORDER_ID_ALREADY_EXISTS look up the existing transaction, because Idempotency-Key is ignored
3. Commit before the calculation's expires_at. If it has expired, calculate again and commit the new calculation_id with the original reference_order_id
4. Send amount as the line total in minor units to /tax/calculations and as the per-unit price to /tax/platform/calculations
5. Start with an sk_test_ key. Certificate endpoints and MCP certificate tools are live only and answer TESTMODE_NOT_SUPPORTED or live_mode_required