Get Variant
Variants
Get Variant
Get a single variant by ID
GET
Get Variant
There is no dedicated variant endpoint on the OAuth App API (
/api/v1/).
Installed apps read variants embedded on their parent product via
GET /api/v1/products/{id}.json — the
response includes a variants[] array.The route documented here is the merchant admin route
(GET /variants/get-single-variant/{id}), authenticated with a merchant
session token (any authenticated store user), not an app access token. It is
also the route the MCP tools and the admin UI use.Authentication
Merchant JWT (Authorization: Bearer <merchant-token>). Any authenticated
user of the store may call it.
Path Parameters
The variant ID
Response
The platform response envelope is{ status, state, message, data }. The
data object is the raw variant record.
HTTP status code (e.g.
200)."success" or "error".null on success, an error string otherwise.If the variant does not exist the endpoint returns
status: 400 with
state: "error" and message: "Variant Not Found".