Construction Industry Scheme Bands

Only available to UK companies enrolled in the Construction Industry Scheme

Minimum access level:

  • Estimates & Invoices

List all CIS bands for a company

GET https://api.freeagent.com/v2/cis_bands

Since these bands do not change frequently, we suggest caching them client-side and updating every once in a while, for example once a day or at app start-up. Use the names of the bands in conjunction with the cis_rate attribute on invoices.

Response

Status: 200 OK
{
  "available_bands": [
    {
      "name": "cis_gross",
      "deduction_rate": "0.0",
      "income_description": "CIS Income (Gross)",
      "deduction_description": "CIS Deduction (Gross)",
      "nominal_code": "061"
    },
    {
      "name": "cis_standard",
      "deduction_rate": "0.2",
      "income_description": "CIS Income (20%)",
      "deduction_description": "CIS Deduction (20%)",
      "nominal_code": "062"
    },
    {
      "name": "cis_higher",
      "deduction_rate": "0.3",
      "income_description": "CIS Income (30%)",
      "deduction_description": "CIS Deduction (30%)",
      "nominal_code": "063"
    }
  ]
}
Show as XML
<?xml version="1.0" encoding="UTF-8"?>
<freeagent>
  <available-bands type="array">
    <available-band>
      <name>cis_gross</name>
      <deduction-rate type="decimal">0.0</deduction-rate>
      <income-description>CIS Income (Gross)</income-description>
      <deduction-description>CIS Deduction (Gross)</deduction-description>
      <nominal-code>061</nominal-code>
    </available-band>
    <available-band>
      <name>cis_standard</name>
      <deduction-rate type="decimal">0.2</deduction-rate>
      <income-description>CIS Income (20%)</income-description>
      <deduction-description>CIS Deduction (20%)</deduction-description>
      <nominal-code>062</nominal-code>
    </available-band>
    <available-band>
      <name>cis_higher</name>
      <deduction-rate type="decimal">0.3</deduction-rate>
      <income-description>CIS Income (30%)</income-description>
      <deduction-description>CIS Deduction (30%)</deduction-description>
      <nominal-code>063</nominal-code>
    </available-band>
  </available-bands>
</freeagent>
Show as JSON