Skip to main content

Get verification status

GET/partner/v1/business-profiles/{customerId}/verification-status
Auth Bearer tokenScope partner.read

Returns the compliance status of a business customer.

tip

Prefer webhooks to polling. ryno sends customer.onboarding.approved, customer.onboarding.rejected and customer.onboarding.changes_requested as soon as a decision is made.

Path​

customerIduuidpathrequired

Response​

customerIduuid
verificationStatusstring
rejectionReasonstring | null

The analyst's message while the status is Rejected or ChangesRequested. null in every other status.

rejectedDocumentsobject[]

While the status is ChangesRequested, each rejected document still waiting for a replacement, oldest rejection first. Empty in every other status. Upload one replacement for each in the same documentCategory; to choose which one a file replaces, send its documentId as replacesDocumentId when you request the upload link.

Show propertiesHide properties
documentIduuid
The rejected document.
documentCategorystring | null
Upload the replacement in this category. null when the document has no category; canReplace is then false.
commentstring | null
The analyst's note on this document.
rejectedAtdate-time
When the analyst rejected it.
canReplaceboolean
false when you cannot upload a replacement: the document belongs to a beneficial owner, has no category, or its category is not one the business can upload, for example after a businessTypeCode change. Don't replace it; the analyst resolves it when the case comes back.

Errors​

Only the common errors. For this endpoint, the customer errors mean:

CodeHTTPWhen
Customer.NotFound404No customer has this customerId.
Customer.NotBusiness400The customerId is not a business customer.
Partner.NotAuthorized403The business is not one of yours.

A customerId that is not a UUID matches no route and returns 404 without the response envelope.