Tax Codes API

Look up available tax codes. You need tax code IDs when creating invoices and bills.

Scope required: tax_codes:read

List Tax Codes


GET /tax-codes

Returns all active tax codes for a region.

Query Parameters

Parameter	Type	Default	Description
`region`	string	`AU`	Region code (e.g. `AU`, `NZ`, `US`, `UK`)

Example Request


curl -H "Authorization: Bearer rb_live_YOUR_API_KEY" \
  "https://api.rebased.app/api/v1/external/tax-codes"

Example Response


{
  "tax_codes": [
    {
      "id": "f339990e-0c70-4961-a52d-d33801a6d6ea",
      "tax_code": "GST",
      "tax_name": "GST (10%)",
      "tax_rate": 10.0,
      "description": "Goods and Services Tax - standard rate",
      "region_code": "AU",
      "is_default": true
    },
    {
      "id": "3d8d9c34-ac8c-4b61-965b-c1870a8170ea",
      "tax_code": "GST-FREE",
      "tax_name": "GST-Free",
      "tax_rate": 0.0,
      "description": "GST-free supplies (e.g., basic food, health services)",
      "region_code": "AU",
      "is_default": false
    }
  ],
  "total": 5
}

Get Tax Code


GET /tax-codes/{id}

Returns a single tax code by ID.

Path Parameters

Parameter	Type	Description
`id`	string (UUID)	The tax code ID

Tax Code Object

Field	Type	Description
`id`	string	Unique identifier (UUID) — use this as `tax_code_id` when creating invoices or bills
`tax_code`	string	Short code (e.g. `GST`, `GST-FREE`, `EXEMPT`)
`tax_name`	string	Display name (e.g. `GST (10%)`)
`tax_rate`	decimal	Tax rate as a percentage (e.g. `10.0` for 10%)
`description`	string	Description of when this tax code applies
`region_code`	string	Region this tax code belongs to
`is_default`	boolean	Whether this is the default tax code for the region

Usage with Invoices and Bills

When creating an invoice or bill, each line item requires a tax_code_id. The API looks up the tax rate from the tax code — you do not need to specify the rate yourself.


{
  "line_items": [
    {
      "description": "Consulting Services",
      "quantity": 5,
      "unit_price": 200.00,
      "account_id": "your-revenue-account-id",
      "tax_code_id": "f339990e-0c70-4961-a52d-d33801a6d6ea"
    }
  ]
}

Australian Tax Codes

Code	Name	Rate	Use for
`GST`	GST (10%)	10%	Most goods and services
`GST-FREE`	GST-Free	0%	Basic food, health, education
`INPUT`	Input Taxed	0%	Financial services, residential rent
`EXEMPT`	Tax Exempt	0%	Input taxed supplies
`N/A`	Not Applicable	0%	Internal accounts, non-taxable items