Skip to main content
GET
Get product by ID

Authorizations

X-Api-Key
string
header
required

Company Level Authentication

Include your API key in the X-Api-Key header for every request:

Headers

snappy-account-id
string

Optional account identifier for swag validation/filtering.

Example:

"acc123456"

snappy-company-id
string

Optional company identifier for swag validation/filtering.

Example:

"cmp123456"

Path Parameters

productId
string
required

Stable product ID.

Pattern: ^(?:^[A-Za-z0-9]{8,}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)$
Example:

"655277e68e0719000d6c3fd5"

Query Parameters

location
string
default:US

ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$
Example:

"US"

filter[price][gte]
number | null

Inclusive minimum variant price filter.

Required range: x >= 0
Example:

10

filter[price][lte]
number | null

Inclusive maximum variant price filter.

Required range: x >= 0
Example:

200

include
enum<string>[]

Related entities to include.

Related entities to include.

Available options:
brand,
tags
Example:
fields
enum<string>[]

Computed or expanded product fields.

Computed or expanded fields for product responses.

Available options:
options,
priceRange,
variantsCount
Example:

Response

Product.

Product.

id
string
required

Stable product identifier.

Example:

"655277e68e0719000d6c3fd5"

title
string
required

Product title.

Example:

"NFL 25-Layer StadiumView Wall Art"

createdAt
string<date-time>
required

Product creation date.

Example:

"2026-05-11T10:53:01.026Z"

media
object[]
required

Product media.

category
object
required

Product category.

catalog
enum<string>
required

Product catalog.

Available options:
marketplace,
swag
Example:

"marketplace"

type
enum<string>
required

Product type.

Available options:
physical,
digital,
giftCard,
donation
Example:

"physical"

brand
object | null

Product or variant brand. Returned only when include=brand. Nullable when the product or variant has no brand.

tags
object[]

Returned only when include=tags.

options
object[]

Aggregated variant options.

priceRange
object

Min/max pricing across the product's variants. Returned only when fields includes priceRange.

variantsCount
integer

Returned only when fields includes variantsCount.

Required range: x >= 0
Example:

9

Last modified on June 17, 2026