Skip to main content
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

id
string
required
The variant ID

Response

The platform response envelope is { status, state, message, data }. The data object is the raw variant record.
status
number
HTTP status code (e.g. 200).
state
string
"success" or "error".
message
string
null on success, an error string otherwise.
data
object
If the variant does not exist the endpoint returns status: 400 with state: "error" and message: "Variant Not Found".