Taxes

The taxes withheld or payable attached to a bill.

Command	HTTP	Description
taxes list	GET /v1/taxes	List taxes
taxes create	POST /v1/taxes	Create a tax
taxes get	GET /v1/taxes/{id}	Get a tax by ID
taxes update	PATCH /v1/taxes/{id}	Update a tax
taxes delete	DELETE /v1/taxes/{id}	Delete a tax

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 taxes
kobana finance taxes list \
  --fields "id,name,default_rate,default_withholding,active"

# Get a tax by ID
kobana finance taxes get --params '{"id": "TAXE_ID"}'

# Create a tax
kobana finance taxes create --json '{"name": "IRRF"}'

# Update a tax
kobana finance taxes update \
  --params '{"id": "TAXE_ID"}' \
  --json '{"name": "IRRF", "default_rate": "1.50", "default_withholding": true}'

# Delete a tax
kobana finance taxes delete --params '{"id": "TAXE_ID"}' --dry-run

Next steps

• Attachments
• Schema introspection — every parameter this resource accepts.