---
title: "Does a CIS subcontractor need verifying?"
method: GET
path: "/api/v1/needs-verification"
tags: ["CIS"]
---

# Does a CIS subcontractor need verifying?

`GET /api/v1/needs-verification`

## Request

- Base URL: `https://0sand1s.co.uk`
- URL: `https://0sand1s.co.uk/api/v1/needs-verification`
- Auth: none declared

Says whether a contractor must verify a subcontractor with HMRC before paying them (SI 2005/2045 reg 6): not needed if the subcontractor was on one of this contractor's CIS returns, or was verified by this contractor, in the tax year of the payment or the two before. Takes the payment date, the tax years the subcontractor was on a return and the last verification date, all supplied by the caller. Does not contact HMRC or verify anyone, and does not cover group companies or business transfers.

## Query parameters

- `payment_date` string, required
- `included_on_return_in_tax_years` integer[]
- `last_verified_on` string

## Response `200`

The answer

- ToolResponse
  - `tool` string, required
  - `result` object, required: The answer. Amounts are { pence, pounds } objects; dates are YYYY-MM-DD.
  - `summary` string, required: The answer in one line
  - `sources` object[], required
    - `title` string
    - `url` string, uri
  - `see_also` string, uri, required: The page on 0sand1s.co.uk that does the same sum or explains the rule

## Other responses

- `400`: Input that could not be used, with a message per field
- `429`: More than 60 requests in a minute from one address

---

[API](https://skmtc.dev/0sand1s/apis/0s-and-1s-cis-api.md) · [All operations](https://skmtc.dev/0sand1s/apis/0s-and-1s-cis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/0sand1s/apis/0s-and-1s-cis-api/revisions/caf4279c7477?raw)