API Docs / Operations / Verification / Update Verification

Update Verification

PUT /tenants/{tenant}/contacts/{code}/verification

Records a verification obtained from HMRC outside the API (number, date and deduction rate), replacing any manual verification already recorded. A verification obtained through an HMRC request cannot be replaced this way: delete it first (409).

Parameters

NameTypeDescription
tenant* path string

The tenant code (the organisation's URL stub)

The tenant code (the organisation's URL stub)

code* path string
{
  "number": "string",
  "date": "2024-01-01T00:00:00Z",
  "taxStatus": "NetOfHigherDeduction"
}

Responses

400 Bad Request
application/problem+json
401 Unauthorized – Invalid or missing API key
403 Forbidden
application/problem+json
404 Not Found
application/problem+json
409 Conflict
application/problem+json