Statutory filing deadlines
get_filing_deadlinesPAID ($0.005, same as any series). Recurring statutory tax deadlines for a country — VAT/GST returns and payments, PAYE/payroll withholding remittances, corporate income tax returns and provisional/instalment payments — as RULES, each cited to the official source with the verbatim phrase that states it, plus the actual DUE DATES in a window, rolled for the country's weekend and national public holidays (every skipped day is listed). Where a rule's source does not say which way a weekend deadline moves, the date is flagged roll_unverified rather than guessed. Countries or taxes we could not verify are returned as a free coverage_gap with reasons, never invented. Pass year_end (MM-DD) to re-anchor corporate-tax rules on the company's own accounting year end. The HTML page /{country}/filing-deadlines shows the rules free. Every JP series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.10) on this series so a later gazette does not silently retire the value.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Window end, YYYY-MM-DD. Default from + 365 days; at most 400 days after from | |
| tax | No | Only this tax's rules and dates | |
| from | No | Window start, YYYY-MM-DD. Default today | |
| api_key | No | API key (bypasses x402; metered for invoicing) | |
| country | Yes | ISO country code | |
| year_end | No | Company accounting year end, MM-DD (e.g. 06-30). Applies to rules marked year_end_variable |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gaps | No | ||
| unit | No | ||
| error | No | Present on a free refusal or error; no charge | |
| notes | No | ||
| stale | No | ||
| value | No | The rules. Each carries its own source {name, url, anchor} and last_confirmed | |
| series | No | ||
| source | No | ||
| status | No | On a coverage gap: researched_no_verified_rule or not_yet_researched | |
| country | No | ||
| due_dates | No | Computed occurrences in the window, sorted by due_date | |
| no_charge | No | ||
| price_usd | No | ||
| confidence | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| bind_series | No | ||
| explanation | No | ||
| label_basis | No | Inputs and the rule ids that produced the two labels | |
| x_next_bind | No | ||
| coverage_gaps | No | Taxes in scope with no verified rule for this country, and why | |
| http_endpoint | No | ||
| coverage_label | No | How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules | |
| effective_from | No | ||
| last_confirmed | No | ||
| confidence_label | No | Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules | |
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card | |
| computed_disclaimer | No |