Get Connection Health Report

Retrieve the connection health for a specific Merchant given their merchant_id. You can use this endpoint to understand whether or not merchants are ready for transactions through your app.

circle-info

This endpoint cached once every 24 hours. The data you see may be stale, although if you refresh a specific merchant, those updates will be reflected here. We highly recommend subscribing to our Webhooksarrow-up-right to get accurate information about when a merchant needs attention.

Get Connection Health Report by MerchantId.

get

ConnectionHealth reports are cached once every 24 hours, if you need to request fresh data, pass ?refresh=true.

Path parameters
merchant_idinteger · int32Required
Query parameters
app_idinteger · int32Optional
refreshbooleanOptional

Will refresh and re-calculate the merchant's connection health. This is a heavy operation and should not be done programmatically. Only pass this param when you have reason to believe something has changed the merchant's status. We recommend using our webhooks to be notified when a merchant has become unhealthy or has completed onboarding.

Default: false
Header parameters
X-Violet-TokenstringRequired
X-Violet-App-SecretstringRequired
X-Violet-App-Idinteger · int32Required
Responses
chevron-right
default

default response

application/json

The container for all status objects comprising merchant connection health

merchant_idinteger · int32Optional

The id of the merchant this connection health report pertains to

merchant_namestringOptional

The name of the merchant this connection health report pertains to

merchant_emailstringOptional

The obfuscated email address of the merchant this connection health report pertains to

merchant_statusstring · enumOptional

The status/state of the merchant this connection health report pertains to

Possible values:
platformstring · enumOptional

The eCommerce platform this merchant uses

Possible values:
store_urlstringOptional

The URL Of the Store

distribution_typestring · enumOptional

The distribution type this merchant is set to

Possible values:
get
/operations/connection_health/{merchant_id}
default

default response

Last updated

Was this helpful?