HMRC recognised
The paperwork that follows every return.
Once a return is filed, each subcontractor needs a statement of what they were paid and what was deducted. The same API that files the return produces the statements, so the two always agree.
- Monthly and annual statements per subcontractor
- Download as PDF, one at a time or all together
- Email a statement to the subcontractor from the API
- Built from the same payments as the CIS300 return
How it works
How statements work.
Record payments
Add the invoices and payments as you make them. Deductions are worked out against each subcontractor's rate.
Generate the statement
Fetch a subcontractor's statement for a month or a year, as data or as a PDF.
Send it
Email the statement to the subcontractor and check which statements have already gone.
Endpoints
The calls you need.
Every request is sent to https://api.cismanager.com with your API key in the x-api-key header. Each endpoint links to its full reference.
| Method | Endpoint | What it does |
|---|---|---|
| GET | /tenants/{tenant}/statements | List statements across subcontractors |
| GET | /tenants/{tenant}/contacts/{code}/statements/{year}/{month}/pdf | Download a monthly statement as PDF |
| GET | /tenants/{tenant}/contacts/{code}/statements/{year}/pdf | Download an annual statement as PDF |
| POST | /tenants/{tenant}/contacts/{code}/statements/{year}/{month}/emails | Email a monthly statement to the subcontractor |
Example
Download a statement, then email it.
# A subcontractor's statement for a tax month, as a PDF GET https://api.cismanager.com/tenants/{tenant}/contacts/{code}/statements/2026/10/pdf x-api-key: your-api-key # Email the same statement to the subcontractor POST https://api.cismanager.com/tenants/{tenant}/contacts/{code}/statements/2026/10/emails x-api-key: your-api-key
Responses are trimmed to the main fields. The API reference has every field and an OpenAPI spec to generate a client from.
Questions
Common questions.
Do contractors have to give subcontractors a CIS statement?
Yes. A contractor must give each subcontractor a payment and deduction statement within 14 days of the end of every tax month, showing what was paid and what was deducted.
Are there monthly and annual statements?
Both. Fetch a statement for one tax month or for a whole tax year, as data or as a PDF.
Do the statements match the CIS300 return?
They are built from the same invoices and payments as the return, so the figures agree.
New to the scheme? CIS tax explained covers the 0%, 20% and 30% rates, and the CIS HMRC API overview shows how the API fits together.
More