GET

/v1/merchants/{merchant_id}

X-Violet-Token
X-Violet-App-Secret
X-Violet-App-Id
curl --request GET \
  --url https://sandbox-api.violet.io/v1/merchants/{merchant_id}
{
  "annual_revenue": "L_E_100K",
  "billing_configured": "boolean",
  "category": "OTHER",
  "commission_rate": "number",
  "connection_status": "NOT_CONNECTED",
  "custom_store_url": "string",
  "date_created": "string",
  "date_last_modified": "string",
  "default": "boolean",
  "default_country_code": "string",
  "default_currency": "string",
  "default_language_code": "string",
  "default_size_unit": "INCHES",
  "default_state_code": "string",
  "default_weight_unit": "INCHES",
  "distribution_type": "PUBLIC",
  "email": "string",
  "external_id": "string",
  "featured": "boolean",
  "id": "integer",
  "logo": "string",
  "merchant_name": "string",
  "platform": "shopify",
  "referral_source": "VIOLET",
  "shipping_configured": "boolean",
  "status": "inactive",
  "store_url": "string",
  "taxes_configured": "boolean",
  "user_id": "integer",
  "verified": "boolean"
}

Retrieve merchant details based on a given merchant_id.

Headers

X-Violet-Token
string
X-Violet-App-Secret
string
X-Violet-App-Id
integer

Path Parameters

merchant_idrequired
integer

Query Parameters

app_id
integer

Response

200 - application/json
annual_revenue
enum<string>

Annual Revenue

Available options:
L_E_100K,
G_100K_L_E_1M,
G_1M_L_E_100M,
G_100M
billing_configured
boolean

The billing status of the merchant

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
commission_rate
number

The default commission rate of the merchant

connection_status
enum<string>

If a developers application has access to this merchant.

Available options:
NOT_CONNECTED,
CONNECTED,
REQUESTED,
DECLINED
custom_store_url
string

The custom URL of the Store

date_created
string

Date of creation

date_last_modified
string

Date of last update

default
boolean
default_country_code
string

The default country of origin of merchant

default_currency
string

The default currency used by merchant

default_language_code
string

The default language used by merchant

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
default_state_code
string

The default state / province of origin of merchant

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
distribution_type
enum<string>

ID of the Merchant on Ecommerce Platform

Available options:
PUBLIC,
PRIVATE
emailrequired
string

The Merchants unique email address

external_id
string

ID of the Merchant on Ecommerce Platform

featured
boolean

Featured Merchant

id
integer
logo
string

URL of the merchants logo

merchant_namerequired
string

The name of the merchants business

platformrequired
enum<string>

The eCommerce platform this merchant uses

Available options:
shopify,
magento,
magento_one,
woocommerce,
bigcommerce,
lightspeed,
ecwid,
yaas,
spreecommerce,
demandware,
volusion,
prestashop,
threedcart
referral_source
enum<string>

Source of the merchant referral

Available options:
VIOLET,
PLATFORM_MARKETPLACE,
AFFILIATE_PROGRAM,
OTHER
shipping_configured
boolean

The shipping status of the merchant

status
enum<string>

The status of the merchant

Available options:
inactive,
active,
disabled,
new
store_url
string

The URL of the Store

taxes_configured
boolean

The tax status of the merchant

user_idrequired
integer

The Id of the User who owns this Merchant Account

verified
boolean

If a user has verified their email address