# Get a list of tax bands

Get a list of tax bands e.g. VAT

Endpoint: GET /tax-bands
Version: 1.12
Security: bearerAuth

## Query parameters:

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

  - `name` (string)
    Filter by name
    Example: "xyz | in:x,y | like:xyz"

  - `defaultBand` (string)
    Filter to default Tax bands
    Example: "true | false"

  - `tNumber` (string)
    Filter by T number
    Example: "xyz | in:x,y | like:xyz"

## Response 200 fields (application/json):

  - `id` (integer)
    Internal identifier of tax band
    Example: 1

  - `code` (string, required)
    Default tax code for this band e.g. T1 for standard UK rated transactions

  - `name` (string, required)
    Name of the tax band

  - `defaultBand` (boolean, required)
    Specifies this is the default tax band to use

  - `usedForEtc` (boolean)
    Specifies this tax band is used for early termination charges


## Response 400 fields

## Response 401 fields

## Response 404 fields

## Response 412 fields

## Response 500 fields

## Response 501 fields