Tax periods

The tax periods that group issued invoices.

Command	HTTP	Description
tax-periods list	GET /v1/tax_periods	List tax periods
tax-periods create	POST /v1/tax_periods	Process the monthly tax period
tax-periods get	GET /v1/tax_periods/{id}	Get a tax period
tax-periods update	PATCH /v1/tax_periods/{id}	Run an action on the tax period
tax-periods delete	DELETE /v1/tax_periods/{id}	Delete a tax period

Examples

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List tax periods
kobana billing tax-periods list \
  --fields "id,public_id,external_id,company_id,period_type"

# Get a tax period
kobana billing tax-periods get --params '{"id": "TAX_PERIOD_ID"}'

# Process the monthly tax period
kobana billing tax-periods create --json '{"year": 2026, "month": 6}'

# Run an action on the tax period
kobana billing tax-periods update \
  --params '{"id": "TAX_PERIOD_ID"}' \
  --json '{"action": "recalculate"}'

# Delete a tax period
kobana billing tax-periods delete --params '{"id": "TAX_PERIOD_ID"}' --dry-run

Next steps

• Digital certificates
• Schema introspection — every parameter this resource accepts.