Skip to main content
GET
List filings

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

corporation_id
string<uuid>
required

The unique identifier of the corporation whose filings to list.

v2
enum<string>
required

Set to true. Required for the response and filters documented on this page.

Available options:
true
cursor
string

The cursor from the previous page. Omit it for the first page. When a response has no cursor, you have reached the last page.

limit
integer
default:10

Number of filings per page.

Required range: 1 <= x <= 100
filing_statuses
string

Comma-separated list of statuses to return. Allowed values: SCHEDULED, ACCRUING, ACTIVE, FILED, OVERDUE. An unknown value returns a 400.

Example:

"ACTIVE,OVERDUE"

from_due_date
string<date>

Returns only filings whose filing_due_date is on or after this date (YYYY-MM-DD).

to_due_date
string<date>

Returns only filings whose filing_due_date is on or before this date (YYYY-MM-DD).

jurisdiction_ids
string

Comma-separated list of Commenda jurisdiction identifiers. Maximum 100 values.

Example:

"STATE_CEN_06,COUNTRY_DE_3018"

filing_frequencies
string

Comma-separated list of filing frequencies (see filing_frequency). Maximum 100 values. An unknown value returns a 400.

Example:

"MONTHLY,QUARTERLY"

registration_tax_type_id
string

Returns only filings for this registration tax type.

Example:

"REG_STATE_CEN_06_RST"

extend
enum<string>

Set to filing_contribution to include the EU/UK VAT box values on each filing as a contributions array. Any other value returns a 400.

Available options:
filing_contribution

Response

A page of filings

data
object
message
string
Example:

"Successfully fetched filings."