Sign in
Retailers

GET /retailers/public/{retailer_id}

This endpoint retrieves information about a retailer given their ID. Use the isUpmarketPlusRetailer field to determine whether the retailer requires a packing slip in every shipping package when fulfilling their orders.

get/retailers/public/{retailer_id}

Path parameters

retailer_idstring required

Response

Successful response

retailer_idstring

A unique identifier for the retailer.

namestring

The name of the retailer's business.

is_insiderboolean

Indicates whether this retailer currently has an active Faire Insider membership. This field is true if the retailer has an active isInsider membership (TRIALING or ACTIVE status), and false otherwise (no membership, or CANCELLED/UNPAID/PAUSED status).

is_upmarket_plus_retailerboolean

Indicates whether this retailer is an Upmarket Plus retailer.

Example response

{
  "retailer_id": "r_c9385ldj",
  "name": "Faire Wholesale, Inc",
  "is_insider": true,
  "is_upmarket_plus_retailer": true
}