API Docs / Operations / Client - Agent Authorisations / Verify Authorisation With HMRC

Verify Authorisation With HMRC

POST /tenants/{tenant}/clients/{client}/agent-authorisations/verify

Asks HMRC whether the practice currently holds a Making Tax Digital authorisation for this client, and in what capacity. A confirmation sets the status to Granted and records the identifier HMRC matched. HMRC not recognising the authorisation never changes the stored status — the result is recorded for review, because it is equally consistent with an out-of-date postcode or National Insurance number held for the client.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
{
  "authorisationType": "SelfAssessment"
}

Responses

400 Bad Request
401 Unauthorized – Invalid or missing API key
404 Not Found