Skip to main content
The Statutory Compliance API automates the post-payroll compliance lifecycle — filing statutory returns with government authorities and remitting payments through Cadana’s local payment rails. It builds on the existing Tax Calculation, Person, and Payroll APIs.

​
Key Capabilities

Automated Filings

Create and submit statutory returns to government authorities across jurisdictions.

Government Remittances

Pay what’s owed through local payment rails with automatic FX conversion.

Compliance Dashboard

Real-time visibility into filing status, deadlines, and requirements across all countries.

Audit Trail

Every action recorded with legislative citations and immutable event history.

​
Choose What You Need

Filing and remittance are two co-equal products. A remittance always points at an accepted filing — what varies between modes is who prepared the filing data and whether Cadana also moves the money.

Filing Only

Cadana prepares and submits statutory returns to the authority. You handle the payment yourself outside Cadana.

Remittance Only

You file with the authority yourself, then submit the resulting totals to Cadana so Cadana can pay the authority through local rails.

Filing + Remittance

The full loop. Cadana prepares the filing, submits to the authority, and pays.
The data model is the same across all three — a Filing resource (with source: cadana or source: external) plus, where applicable, a Remittance resource that references it. The difference between modes is which endpoints you call:
  • Filing only — Create filings with source: cadana and approve them for submission. Skip the /remittances endpoints entirely. See the Filing guide.
  • Remittance only — Create filings with source: external (you provide totals + filingReference + per-employee breakdown), then call POST /v1/statutory/remittances. See the Remittance-only walkthrough.
  • Both — Create filings with source: cadana, approve them, then remit. See the full loop guide.

​
The Compliance Loop

1

Calculate taxes

The Tax Calculation API computes gross-to-net deductions with legislative citations.
2

File statutory returns

Create filings from payroll runs — Cadana determines applicable filing types per jurisdiction.
3

Remit to government

Initiate government payments through local payment rails with automatic currency conversion.
4

Prove compliance

Download filed documents, payment receipts, and audit the full event trail.

​
Submitting Compliance Data

The statutory API is the single front door for all filing data. You discover what’s needed, check what’s missing, and submit it through the statutory endpoints. See the Getting Started guide for the full workflow.
WhatEndpoint
Person filing fieldsPUT /v1/statutory/persons/{id}/fields/{cc}
Business filing fieldsPUT /v1/statutory/businesses/{id}/fields/{cc}
Tax calculation inputsPUT /v1/persons/{id}/taxProfile
Data already on the person or business record (name, address, tax ID, etc.) auto-populates — you only need to submit what’s actually missing.
When missing data is submitted, the Statutory API detects the change and unblocks filings automatically — no manual retries needed.

​
Filing Lifecycle

source: cadana filings follow the full lifecycle below. source: external filings are created directly in accepted and skip the submission states — Cadana never submits them to the authority because you already did. 
pending → in_review → approved → submitted → accepted
  |           |                        |
  v           v                        v
blocked    blocked                  rejected
  |           |                        |
  v           v                        v
pending    pending               pending (retry)
  • pending — Created with amounts, being validated
  • in_review — Validated and ready for approval
  • approved — Queued for submission to government authority
  • submitted — Sent to the authority
  • accepted — Authority acknowledged receipt. Terminal state for cadana and external filings alike.
  • blocked — Missing data or requirements prevent submission
  • rejected — Authority rejected the filing — returns to pending for correction
  • cancelled — Filing was cancelled

​
Guides

Getting Started

Discover jurisdictions, required fields, and outstanding requirements

Statutory Filing

Create, review, approve, and submit filings to government authorities

Statutory Remittance

Pay government authorities with automatic FX conversion

The Full Loop

Walk through the complete calculate, file, remit, prove cycle

​
API Reference

Statutory Compliance API

Full endpoint documentation