Skip to main content
GET
Get verification linkage
Requires scope: manage:parties — see Required scopes. Returns the party’s verification linkage: the linkage status plus the durable ivCaseReference you can quote to support when investigating a stuck verification.
This endpoint reports the plumbing, not the verdict. For the actual KYC/KYB outcome, read kycStatus/kybStatus from Get a party.
ivCaseReference is populated once the platform returns a reference and is never cleared afterwards — including on FAILED after a decline. Read the field directly rather than inferring it from status. This always returns 200 for an existing party, and reflects party-level linkage only — never your company’s tenant provisioning state.

Authorizations

Path Parameters

partyId
string<uuid>
required

Unique party identifier

Response

The party's verification linkage

success
boolean

Indicates whether the request was successful

result
object

A party's identity-verification linkage: the current linkage status plus the durable case reference. ivCaseReference is populated once the platform has returned a reference and is never cleared afterwards — including on FAILED after a declined verdict. Read it directly rather than inferring it from status.