Get Connection Health

Get Connection Health Reports for all merchants that you are connected to.

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 Webhooks to get accurate information about when a merchant needs attention.

Get Connection Health

get

Reports for all accessible merchants.

Query parameters

app_idinteger · int32Required

exclude_publicbooleanOptionalDefault: true

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Responses

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

HTTPcURLJavaScriptPython

GET /v1/operations/connection_health?app_id=1 HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Accept: */*

default

default response

[
  {
    "merchant_id": 1,
    "merchant_name": "text",
    "merchant_email": "text",
    "merchant_status": "INACTIVE",
    "platform": "OTHER",
    "store_url": "text",
    "distribution_type": "PUBLIC",
    "connection": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "isConnected": true,
        "hasActivePlatformPlan": true,
        "hasShippingMethods": true,
        "storeScopes": {
          "hasValidScopes": true,
          "requiredScopes": [
            "text"
          ],
          "missingScopes": [
            "text"
          ]
        },
        "connected": true
      }
    },
    "scope_validation": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "valid": true,
        "missing_scopes": [
          "text"
        ]
      }
    },
    "sync_status": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "id": 1,
        "merchant_id": 1,
        "status": "NOT_STARTED",
        "abort": true,
        "total_products": 1,
        "total_products_synced": 1,
        "resync_required": true,
        "date_last_synced": "2026-02-20T13:55:59.775Z",
        "taxonomy_synced": true,
        "webhooks_created": true,
        "date_shipping_last_synced": "2026-02-20T13:55:59.775Z",
        "app_id": 1
      }
    },
    "invalid_products": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "count": 1,
        "invalid_product": {
          "id": 1,
          "external_id": "text",
          "name": "text",
          "thumbnail_url": "text",
          "merchant_id": 1,
          "issues": "text",
          "status": "UNRESOLVED",
          "date_created": "2026-02-20T13:55:59.775Z",
          "date_last_modified": "2026-02-20T13:55:59.775Z"
        }
      }
    },
    "offers_published": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "sync_complete": true,
        "count": 1
      }
    },
    "payout_account": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": {
        "id": 1,
        "account_type": "MERCHANT",
        "account_id": 1,
        "merchant_id": 1,
        "app_id": 1,
        "is_active": true,
        "country_code": "text",
        "payment_provider": "STRIPE",
        "payment_provider_account_id": "text",
        "payment_provider_account_type": "EXPRESS",
        "payment_provider_metadata": {
          "ANY_ADDITIONAL_PROPERTY": {}
        },
        "payment_provider_account": {},
        "date_deactivated": "2026-02-20T13:55:59.775Z",
        "errors": [
          {
            "id": 1,
            "error_code": 1,
            "error_message": "text",
            "resolved": true,
            "date_resolved": "2026-02-20T13:55:59.775Z",
            "date_created": "2026-02-20T13:55:59.775Z",
            "payout_account_id": 1
          }
        ],
        "date_created": "2026-02-20T13:55:59.775Z",
        "date_last_modified": "2026-02-20T13:55:59.775Z"
      }
    },
    "migration": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "results": "MIGRATION_REQUIRED"
    },
    "commission_rate": {
      "status": "COMPLETE",
      "error": {
        "message": "text",
        "error": "text",
        "code": 1,
        "data": {
          "cause": "ORDER_ERROR",
          "skus": [
            {
              "message": "text",
              "name": "text",
              "skuId": 1,
              "orderSkuId": 1,
              "bagId": 1
            }
          ]
        },
        "id": {},
        "ids": [
          {}
        ]
      },
      "default_rate": 1,
      "overrides": [
        {
          "status": "COMPLETE",
          "error": {
            "message": "text",
            "error": "text",
            "code": 1,
            "data": {
              "cause": "ORDER_ERROR",
              "skus": [
                {
                  "message": "text",
                  "name": "text",
                  "skuId": 1,
                  "orderSkuId": 1,
                  "bagId": 1
                }
              ]
            },
            "id": {},
            "ids": [
              {}
            ]
          },
          "app_id": 1,
          "rate": 1,
          "commission_locked": true
        }
      ]
    }
  }
]