Search Merchants - Violet Documentation

Search for merchants you are connected to given certain filter criteria.

Headers

X-Violet-Token

string

X-Violet-App-Secret

string

X-Violet-App-Id

integer

Query Parameters

page

integer

default:

size

integer

default:

Body

application/json

commission_rate_max

number

The maximum commission rate of the Merchant

commission_rate_min

number

The minimum commission rate of the Merchant

integer

The ID of the Merchant

name

string

The name of the Merchant

sort_by

string

Property to sort by in camelCase

sort_direction

string

Direction to sort by

status

enum<string>

The connection status of the Merchant

Available options:

ANY,

CONNECTED,

PRIVATE,

PUBLIC

Response

default - application/json

content

object[]

The actual content of the response; A list of the result objects

content.email

string

required

The Merchants unique email address

content.merchant_name

string

required

The name of the merchants business

content.platform

enum<string>

required

The eCommerce platform this merchant uses

Available options:

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

content.user_id

integer

required

The Id of the User who owns this Merchant Account

content.billing_configured

boolean

deprecated

The billing status of the merchant. Deprecated (not reliable) use connection health endpoint instead.

content.category

enum<string>

Merchant Category

Available options:

OTHER,

APPAREL_AND_ACCESSORIES,

ANIMALS_AND_PET_SUPPLIES,

ARTS_AND_ENTERTAINMENT,

BABY_AND_TODDLER,

BUSINESS_AND_INDUSTRIAL,

CAMERAS_AND_OPTICS,

ELECTRONICS,

FOOD_BEVERAGE_TOBACCO,

FURNITURE,

HARDWARE,

HEALTH_AND_BEAUTY,

HOME_AND_GARDEN,

LUGGAGE_AND_BAGS,

MATURE,

MEDIA,

OFFICE_SUPPLIES,

RELIGIOUS_AND_CEREMONIAL,

SOFTWARE,

SPORTING_GOODS,

TOYS_AND_GAMES,

VEHICLES_PARTS

content.commission_rate

number

The default commission rate of the merchant

content.connection_status

enum<string>

deprecated

If a developers application has access to this merchant. Deprecated (not reliable) use connection health endpoint instead.

Available options:

NOT_CONNECTED,

CONNECTED,

REQUESTED,

DECLINED

content.custom_store_url

string

The custom URL of the Store

content.date_created

string

Date of creation

content.date_last_modified

string

Date of last update

content.default

boolean

Is this a Users default merchant

content.default_country_code

string

The default country of origin of merchant

content.default_currency

string

The default currency used by merchant

content.default_language_code

string

The default language used by merchant

content.default_size_unit

enum<string>

Default Unit of Size in the Merchants Store

Available options:

INCHES,

FEET,

CENTIMETERS,

OUNCES,

POUNDS,

GRAMS,

KILOGRAMS,

CARATS,

YARDS,

MILLIMETERS,

TONNES,

MILLIGRAMS,

LITERS,

MILLILITERS,

QUARTS,

QUARTERS,

GALLONS,

PINTS,

METERS

content.default_state_code

string

The default state / province of origin of merchant

content.default_weight_unit

enum<string>

Default Unit of Weight in the Merchants Store

Available options:

INCHES,

FEET,

CENTIMETERS,

OUNCES,

POUNDS,

GRAMS,

KILOGRAMS,

CARATS,

YARDS,

MILLIMETERS,

TONNES,

MILLIGRAMS,

LITERS,

MILLILITERS,

QUARTS,

QUARTERS,

GALLONS,

PINTS,

METERS

content.distribution_type

enum<string>

Determines if the merchants products are available to all apps or only available to apps of their choosing

Available options:

PUBLIC,

PRIVATE

content.external_id

string

ID of the Merchant on Ecommerce Platform

content.featured

boolean

deprecated

Featured Merchant. Deprecated (not used)

content.id

integer

content.logo

string

URL of the merchants logo

content.merchantDisabled

boolean

content.platform_plan

string

The eCommerce platform plan of the store

content.referral_source

enum<string>

Source of the merchant referral

Available options:

VIOLET,

PLATFORM_MARKETPLACE,

AFFILIATE_PROGRAM,

OTHER

content.shipping_configured

boolean

deprecated

The shipping status of the merchant. Deprecated (not reliable)

content.status

enum<string>

The status of the merchant

Available options:

INACTIVE,

ACTIVE,

DISABLED,

NEW,

DISABLED_INACTIVE,

FOR_DELETION,

APPLICATION_IN_PROGRESS,

APPLICATION_SUBMITTED,

APPLICATION_DENIED,

APPLICATION_ACCEPTED

content.store_url

string

The URL of the Store

content.taxes_configured

boolean

deprecated

The tax status of the merchant. Deprecated (not reliable)

content.verified

boolean

deprecated

If a user has verified their email address. Deprecated (not used will always be false)

empty

boolean

Boolean indicating if the response content is empty

first

boolean

Boolean indicating if this is the first page of the response

last

boolean

Boolean indicating if this is the last page

next_page_cursor

string

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.

number

integer

The page number selected at request time

number_of_elements

integer

The total number of objects in this specific response

pageable

object

Violet wrapper for springframework pageable

size

integer

The page size selected at request time

sort

object

Violet Wrapper for springframework sort

total_elements

integer

The total count of objects available

total_pages

integer

The total count of pages available