Skip to main content

Get Sales Tax Liability

GET 
/api/reporting/sales-tax/liability

Sales Tax Liability Report: tax collected and sales aggregated by destination jurisdiction (country + region), with a taxable / non-taxable split and Net Tax (tax collected minus refunded tax from credits). Amounts are converted to the tenant base currency.

Required scope: reports:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token (scope rw:reports).

Required parameters:

  • date_from: report period start
  • date_to: report period end (>= date_from)

Optional:

  • channel_ids[]: restrict to specific sales channels
  • country_code: destination country ISO code (max 3)
  • order_statuses[]: draft | reserved | open | closed (default open + closed)
  • province_code: destination region/state code (max 10)
  • group_by: state | in_state_out_of_state | responsibility | state_responsibility (default state)

The responsibility and state_responsibility lenses (Phase 2) split tax by who collects & remits it: the seller, or a marketplace facilitator (Amazon/eBay/Walmart/Temu/Faire by default). Rows then also carry tax_collection_responsibility, is_default_classification, seller_net_tax and marketplace_net_tax. The is_home_state flag marks the tenant's resolved home nexus jurisdiction. Rows are sorted by net_tax descending.

Request​

Responses​

OK

Response Headers
    Content-Type