CIS Details Requests
Requests for a subcontractor's CIS details (contractor module only), as a child of the subcontractor: the tenant emails the subcontractor a link to a public form, what they enter (type, name, UTR, National Insurance number, company number) is held on the request, and the tenant reviews it and accepts it onto the contact. An SDC statement can go with the request, and the form then leads on to it. The public form's calls need no credentials: the request's code is the key.
-
GET Get Public CIS Details RequestThe request as the subcontractor sees it on the public form, with no credentials: who asked, whom, whether the details have been sent, the SDC stateme.../cis-details-requests/{request}
-
GET Get Public CIS Details Request LogoThe logo of the tenant that sent the request, with no credentials; 404 for an unknown code or when the tenant has no logo./cis-details-requests/{request}/logo
-
PUT Submit CIS DetailsSends the subcontractor's CIS details from the public form, with no credentials. They are held on the request for the tenant to review (the contact is.../cis-details-requests/{request}/details
-
GET List Tenant CIS Details RequestsThe tenant's CIS details requests in one status across all its subcontractors, the latest change first. The status defaults to Submitted: the details .../tenants/{tenant}/cis-details-requests
-
GET List CIS Details RequestsThe contact's CIS details requests, newest first. At most one is unfinished (Pending or Submitted)./tenants/{tenant}/contacts/{code}/cis-details-requests
-
POST Create CIS Details RequestCreates a pending request for the subcontractor and emails them a link to the public form where they enter their CIS details, with no account. With sd.../tenants/{tenant}/contacts/{code}/cis-details-requests
-
GET Get CIS Details RequestOne of the contact's requests, with the details the subcontractor sent once they have./tenants/{tenant}/contacts/{code}/cis-details-requests/{request}
-
DELETE Delete CIS Details RequestCancels a pending request (the emailed link stops working) or discards details awaiting review. An SDC statement sent with it stays among the contact'.../tenants/{tenant}/contacts/{code}/cis-details-requests/{request}
-
POST Send CIS Details Request EmailSends the link to the form again, to the given address, which becomes the request's emailedTo; 202 with the request. 409 once the subcontractor has se.../tenants/{tenant}/contacts/{code}/cis-details-requests/{request}/emails
-
PUT Accept CIS Details RequestPuts the details the subcontractor sent onto the contact: its CIS identity and, where they gave one, the person's name. The contact's verification is .../tenants/{tenant}/contacts/{code}/cis-details-requests/{request}/acceptance