Skip to main content
Weavr API
Corporates

Get KYB for a corporate

GET/corporates/kyb

Returns the KYB lifecycle status and every KYB run for the logged-in corporate. Use corporateKybStatus to decide whether the corporate may use financial services, and kybRuns to show the detailed progress of each verification attempt.

kybStatus and ongoingKybStatus are deprecated but remain populated for backward compatibility.

Read Corporate due diligence and KYB for the verification flow and status handling.

Request

Available on
SandboxProduction

No request parametersThis endpoint doesn’t accept query parameters or a request body.

Responses

200OK

Success

Headers
Body
application/json
{}
objectobject · 4 fields
Response example
{  "kybStatus": {},  "ongoingKybStatus": {},  "corporateKybStatus": {},  "kybRuns": [    {      "id": "string",      "regulatoryFi": "string",      "status": {},      "runType": {},      "startedTimestamp": "string",      "endedTimestamp": "string",      "notes": "string"    }  ]}