- Get API Keys
- Welcome
Access
Offers
SKUs
Categories
Collections
Currencies
Cart
Payment
Customer
Completion
Shipping
Discounts
Items
Refunds
Orders
Merchant
Configuration
Explore
Webhooks
Webhook Events
Wekbhook Headers
Merchant/App Installs
Connection
Shipping
Overview
Login
Catalog
Orders & Checkout
Merchants
Events
Apps
Operations
Relay
Search Connection Health
Search, Filter and Sort Connection Health reports for all accessible merchants, paged
Request object for searching, sorting and filtering ConnectionHealth
A partial match query against either merchantId or merchantName
A list of platforms to filter by
Filter by ConnectionHealth Status
Property to sort by in camelCase
Direction to sort by
curl --request POST \
--url https://sandbox-api.violet.io/v1/operations/connection_health/search \
--header 'Content-Type: application/json' \
--data '{
"query": "<string>",
"platforms": [
"OTHER"
],
"status": "COMPLETE",
"sort_by": "merchantId, merchantName, status, platform",
"sort_direction": "asc, desc"
}'
{
"content": [
{
"merchant_id": 123,
"merchant_name": "<string>",
"merchant_email": "<string>",
"merchant_status": "INACTIVE",
"platform": "OTHER",
"store_url": "<string>",
"distribution_type": "PUBLIC",
"connection": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"isConnected": true,
"hasActivePlatformPlan": true,
"hasShippingMethods": true,
"storeScopes": {
"hasValidScopes": true,
"requiredScopes": [
"<string>"
],
"missingScopes": [
"<string>"
]
},
"connected": true
}
},
"scope_validation": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"valid": true,
"missing_scopes": [
"<string>"
]
}
},
"sync_status": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"id": 123,
"merchant_id": 123,
"status": "NOT_STARTED",
"abort": true,
"total_products": 123,
"total_products_synced": 123,
"resync_required": true,
"date_last_synced": "2023-11-07T05:31:56Z",
"taxonomy_synced": true,
"webhooks_created": true
}
},
"invalid_products": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"count": 123,
"invalid_product": {
"id": 123,
"external_id": "<string>",
"name": "<string>",
"thumbnail_url": "<string>",
"merchant_id": 123,
"issues": "<string>",
"status": "UNRESOLVED",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
}
},
"offers_published": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"sync_complete": true,
"count": 123
}
},
"payout_account": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"id": 123,
"account_id": 123,
"account_type": "MERCHANT",
"external_id": "<string>",
"country_code": "<string>",
"status": "INCOMPLETE",
"verified": true,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"payment_service_account_type": "EXPRESS",
"payment_service": "STRIPE",
"details": {
"legal_entity_address_city": "<string>",
"legal_entity_address_state": "<string>",
"legal_entity_address_country": "<string>",
"legal_entity_address_postal_code": "<string>",
"legal_entity_date_of_birth": "2023-11-07T05:31:56Z",
"legal_entity_business_name": "<string>",
"account_holder_name": "<string>",
"legal_entity_business_tax_id": "<string>",
"legal_entity_first_name": "<string>",
"legal_entity_last_name": "<string>",
"legal_entity_ssn_last_four": "<string>",
"legal_entity_type": "<string>",
"ssn_last_4_provided": true,
"tosAccepted": true,
"legal_entity_currency": "<string>",
"statement_descriptor": "<string>",
"website_url": "<string>",
"email": "<string>",
"phone": "<string>",
"payoutsEnabled": true,
"paymentsEnabled": true,
"hasPayoutAccount": true,
"disabledReason": "<string>",
"currentlyDue": [
"<string>"
],
"eventuallyDue": [
"<string>"
],
"pastDue": [
"<string>"
],
"pendingVerification": [
"<string>"
],
"legal_entity_address_line_1": "<string>",
"legal_entity_address_line_2": "<string>"
}
}
},
"migration": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": "MIGRATION_REQUIRED"
},
"commission_rate": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"default_rate": 123,
"overrides": [
{
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"app_id": 123,
"rate": 123,
"commission_locked": true
}
]
}
}
],
"last": true,
"total_pages": 123,
"total_elements": 123,
"first": true,
"number_of_elements": 123,
"size": 123,
"number": 123,
"empty": true,
"next_page_cursor": "<string>",
"pageable": {
"page_number": 123,
"page_size": 123,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 123,
"paged": true,
"unpaged": true
},
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
}
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.
Headers
Query Parameters
Body
A partial match query against either merchantId or merchantName
A list of platforms to filter by
OTHER
, SHOPIFY
, MAGENTO
, MAGENTO_ONE
, WOOCOMMERCE
, BIGCOMMERCE
, LIGHTSPEED
, ECWID
, YAAS
, SPREECOMMERCE
, DEMANDWARE
, VOLUSION
, PRESTASHOP
, THREEDCART
, SYLIUS
, WIX
, SWELL
, MIVA
, WEBSPHERE
, ORACLECC
, SAPCC
, SQUARESPACE
, SHOPWARE
, COMMERCETOOLS
, MEDUSA
, ABICART
, SPRYKER
, MYSTORE
, CENTRA
, XCART
, VTEX
, KIBO
, SALEOR
, VENDO
, CHORD
, DIGITALRIVER
, SQUARE
, AMAZON
, BIGCARTEL
, CUSTOM
Filter by ConnectionHealth Status
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
Property to sort by in camelCase
merchantId, merchantName, status, platform
Direction to sort by
asc, desc
Response
The actual content of the response; A list of the result objects
The id of the merchant this connection health report pertains to
The name of the merchant this connection health report pertains to
The obfuscated email address of the merchant this connection health report pertains to
The status/state of the merchant this connection health report pertains to
INACTIVE
, ACTIVE
, DISABLED
, NEW
, DISABLED_INACTIVE
, FOR_DELETION
, APPLICATION_IN_PROGRESS
, APPLICATION_SUBMITTED
, APPLICATION_DENIED
, APPLICATION_ACCEPTED
The eCommerce platform this merchant uses
OTHER
, SHOPIFY
, MAGENTO
, MAGENTO_ONE
, WOOCOMMERCE
, BIGCOMMERCE
, LIGHTSPEED
, ECWID
, YAAS
, SPREECOMMERCE
, DEMANDWARE
, VOLUSION
, PRESTASHOP
, THREEDCART
, SYLIUS
, WIX
, SWELL
, MIVA
, WEBSPHERE
, ORACLECC
, SAPCC
, SQUARESPACE
, SHOPWARE
, COMMERCETOOLS
, MEDUSA
, ABICART
, SPRYKER
, MYSTORE
, CENTRA
, XCART
, VTEX
, KIBO
, SALEOR
, VENDO
, CHORD
, DIGITALRIVER
, SQUARE
, AMAZON
, BIGCARTEL
, CUSTOM
The URL Of the Store
The distribution type this merchant is set to
PUBLIC
, PRIVATE
The status object for the merchant connection
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The results of the merchant connection check
The status object for the merchant connection
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The results object for scope validation
Indicates if the scopes are valid or not
A list of required scopes that are missing
The status object for the product sync
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
Shopify Product Sync Tracking & Status
Merchant ID
Status of Sync
NOT_STARTED
, PENDING
, IN_PROGRESS
, COMPLETED
, FAILED
, ABORTED
Should the sync be aborted
Total number of products in the store
Total number of products successfully synced
Does this merchant require a resync
Date of last sync
Has the taxonomy been synced
Have the webhooks been created
The status object for the merchant invalid products
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The results object for invalid products
The number of invalid products the merchant has
Any products that could not be synced
ID of product on external platform
Name of product on external platform
URL to product thumbnail
ID of merchant with broken product
Comma separated list of product invalidation reasons
Status of the invalidation
UNRESOLVED
, RESOLVED
Date created
Date of last update
The status object for offers published
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The results object for offers published
Boolean indicating if the merchant's product sync is complete, this status helps give context on why a merchant might not have any published offers
The number of offers the merchant has published
The status object for the merchant payout account
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
Payout Account of the User. Maps to Stripe Connect Account.
ID
Developer or Merchant ID
Account Type
MERCHANT
, DEVELOPER
External ID. Stripe Account ID
Country Code. Country Code for this Payout Account
Status
INCOMPLETE
, COMPLETE
, REQUIRES_UPDATES
Has the account been verified
Date of account creation
Date of last account update
Type of account in the external payment service
EXPRESS
, CUSTOM
, STANDARD
Payment Service used for this payout account
STRIPE
Legal Entity Address City
Legal Entity Address State
Legal Entity Address Country
Legal Entity Address Postal/Zip Code
Legal Entity Date of Birth
Legal Entity Business Name
Account Holder Name
Legal Entity Business Tax ID
Legal Entity First Name
Legal Entity Last Name
Legal Entity SSN Last Four
Legal Entity Type
Has SSN Last 4 been provided
Have the TOS been accepted
Desired Currency of the Legal Entity
The merchants desired statement descriptor
The merchants website
The merchants email
The merchants phone number
Legal Entity Address Line One
Legal Entity Address Line Two
The status object for the merchant payout account migration
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The results of the merchant payout account migration check
MIGRATION_REQUIRED
, MIGRATION_IN_PROGRESS
, MIGRATED
, NOT_APPLICABLE
, ERROR
The status object for the merchant commission rate
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The default commission rate this merchant pays to a channel if it is not overridden
A list of commission rate overrides this merchant has configured
The status of the given property
COMPLETE
, INCOMPLETE
, NEEDS_ATTENTION
, NOT_APPLICABLE
, ERROR
A list of errors encountered during this report run. This is the top level Violet Error object, it can contain any Violet Error, if it is encountered during the report run.
The app id overriding the merchant commission rate
The commission rate this merchant pays to the channel
Indicates if the commission rate is locked or not. Commission rates can only be locked or unlocked by a Channel.
Boolean indicating if this is the last page
The total count of pages available
The total count of objects available
Boolean indicating if this is the first page of the response
The total number of objects in this specific response
The page size selected at request time
The page number selected at request time
Boolean indicating if the response content is empty
Contains the cursor for the next page. This property will only be used for situations where the API does not support the page number/page size paradigm and it will mutually exclusive with the size/number fields in the response. If this property is returned it must be passed when requesting the next page from the API. Does not apply to endpoints that do not have a next_page_cursor query param documented.
Violet wrapper for springframework pageable
The current page number (one based)
The number of elements per page
Violet Wrapper for springframework sort
Boolean indicating if the result set is unsorted
Boolean indicating if the result set is sorted
Boolean indicating if the result set is empty
The offset
Boolean indicating if the result is paged
Boolean indicating if the result is unpaged
Violet Wrapper for springframework sort
Boolean indicating if the result set is unsorted
Boolean indicating if the result set is sorted
Boolean indicating if the result set is empty
Was this page helpful?
curl --request POST \
--url https://sandbox-api.violet.io/v1/operations/connection_health/search \
--header 'Content-Type: application/json' \
--data '{
"query": "<string>",
"platforms": [
"OTHER"
],
"status": "COMPLETE",
"sort_by": "merchantId, merchantName, status, platform",
"sort_direction": "asc, desc"
}'
{
"content": [
{
"merchant_id": 123,
"merchant_name": "<string>",
"merchant_email": "<string>",
"merchant_status": "INACTIVE",
"platform": "OTHER",
"store_url": "<string>",
"distribution_type": "PUBLIC",
"connection": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"isConnected": true,
"hasActivePlatformPlan": true,
"hasShippingMethods": true,
"storeScopes": {
"hasValidScopes": true,
"requiredScopes": [
"<string>"
],
"missingScopes": [
"<string>"
]
},
"connected": true
}
},
"scope_validation": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"valid": true,
"missing_scopes": [
"<string>"
]
}
},
"sync_status": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"id": 123,
"merchant_id": 123,
"status": "NOT_STARTED",
"abort": true,
"total_products": 123,
"total_products_synced": 123,
"resync_required": true,
"date_last_synced": "2023-11-07T05:31:56Z",
"taxonomy_synced": true,
"webhooks_created": true
}
},
"invalid_products": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"count": 123,
"invalid_product": {
"id": 123,
"external_id": "<string>",
"name": "<string>",
"thumbnail_url": "<string>",
"merchant_id": 123,
"issues": "<string>",
"status": "UNRESOLVED",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
}
},
"offers_published": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"sync_complete": true,
"count": 123
}
},
"payout_account": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": {
"id": 123,
"account_id": 123,
"account_type": "MERCHANT",
"external_id": "<string>",
"country_code": "<string>",
"status": "INCOMPLETE",
"verified": true,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"payment_service_account_type": "EXPRESS",
"payment_service": "STRIPE",
"details": {
"legal_entity_address_city": "<string>",
"legal_entity_address_state": "<string>",
"legal_entity_address_country": "<string>",
"legal_entity_address_postal_code": "<string>",
"legal_entity_date_of_birth": "2023-11-07T05:31:56Z",
"legal_entity_business_name": "<string>",
"account_holder_name": "<string>",
"legal_entity_business_tax_id": "<string>",
"legal_entity_first_name": "<string>",
"legal_entity_last_name": "<string>",
"legal_entity_ssn_last_four": "<string>",
"legal_entity_type": "<string>",
"ssn_last_4_provided": true,
"tosAccepted": true,
"legal_entity_currency": "<string>",
"statement_descriptor": "<string>",
"website_url": "<string>",
"email": "<string>",
"phone": "<string>",
"payoutsEnabled": true,
"paymentsEnabled": true,
"hasPayoutAccount": true,
"disabledReason": "<string>",
"currentlyDue": [
"<string>"
],
"eventuallyDue": [
"<string>"
],
"pastDue": [
"<string>"
],
"pendingVerification": [
"<string>"
],
"legal_entity_address_line_1": "<string>",
"legal_entity_address_line_2": "<string>"
}
}
},
"migration": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"results": "MIGRATION_REQUIRED"
},
"commission_rate": {
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"default_rate": 123,
"overrides": [
{
"status": "COMPLETE",
"error": {
"message": "<string>",
"error": "<string>",
"code": 123,
"id": {},
"ids": [
{}
]
},
"app_id": 123,
"rate": 123,
"commission_locked": true
}
]
}
}
],
"last": true,
"total_pages": 123,
"total_elements": 123,
"first": true,
"number_of_elements": 123,
"size": 123,
"number": 123,
"empty": true,
"next_page_cursor": "<string>",
"pageable": {
"page_number": 123,
"page_size": 123,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 123,
"paged": true,
"unpaged": true
},
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
}