List Numeral Filings
GET/api/numeral/instances/:instance/filings
Numeral's sales-tax filings per state and period, newest period first. Served from a cache refreshed by the registration sync; refresh=1 re-reads Numeral now.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each row: id, country_code, region_code, status (Numeral's status), period_start, period_end, due_date, amount_due (decimal, may be null), currency_code, dashboard_url and display_status — filed (submitted or being submitted), due, overdue (past due_date, not filed) or canceled. counts totals the rows per display_status.
The endpoint does not fail when Numeral cannot be reached: available is false with a reason (disconnected, unavailable, auth, rate_limited, error) and message, or the last fetched list is served with stale true. fetched_at is when the list was read from Numeral.
Authentication: Requires a Bearer token. Requires the integrations.sync permission.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.