Get one product

GET

/v1/products/{public_id}

curl --request GET \
  --url https://example.com/v1/products/example \
  --header 'Authorization: Bearer <token>'

Authorizations

• sk_*

Parameters

Path Parameters

public_id

required

Public Id

string

Header Parameters

X-Shopify-Hmac-Sha256

Any of:

string

string

null

null

Responses

200

Successful Response

Media typeapplication/json

ProductResponse

One product owned by the authenticated client.

object

public_id

required

Public Id

string

title

required

Title

string

external_ref

Any of:

string

string

null

null

category

Any of:

ProductCategoryResponse

ProductCategoryResponse

The garment category a product sits in, resolved for display.

object

public_id

required

Public Id

string

key

required

Key

Canonical taxonomy key, e.g. ethnic_top.

string

display_label

required

Display Label

string

null

null

status

required

Status

active | archived.

string

description

Any of:

string

string

null

null

primary_image_url

Any of:

string

string

null

null

source_pdp_image_url

Any of:

string

string

null

null

images

Images

Array<object>

ProductImageResponse

One image on a product.

object

asset_public_id

required

Asset Public Id

string

role

required

Role

primary | gallery | source_pdp.

string

position

required

Position

integer

image_url

required

Image Url

Short-lived presigned URL; not an input handle.

string

created_at

required

Created At

string format: date-time

Example^generated

{
  "public_id": "example",
  "title": "example",
  "external_ref": "example",
  "category": {
    "public_id": "example",
    "key": "example",
    "display_label": "example"
  },
  "status": "example",
  "description": "example",
  "primary_image_url": "example",
  "source_pdp_image_url": "example",
  "images": [
    {
      "asset_public_id": "example",
      "role": "example",
      "position": 1,
      "image_url": "example"
    }
  ],
  "created_at": "2026-04-15T12:00:00Z"
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}