Skip to main content
GET
/
v3
/
base-products
/
{baseProductId}
Get base product by id
curl --request GET \
  --url https://api.snappy.com/public-api/v3/base-products/{baseProductId} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "bp_a1b2c3",
  "title": "<string>",
  "media": [
    {
      "type": "image",
      "src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
    }
  ],
  "category": {
    "fullName": "gifts / electronics / iphones"
  },
  "type": "physical",
  "brand": {
    "id": "621f9d4b1e675adcbc196159",
    "name": "Apple",
    "description": "Cute pet brand"
  }
}

Authorizations

X-Api-Key
string
header
required

Partner API key. Finalized per partner integration agreement.

Path Parameters

baseProductId
string
required

Base product identifier.

Query Parameters

fields
string[]

Optional base-product/base-variant field expansions. Comma-separated.

Response

Single base product.

Base product (swag template). Minimal shape - extended schema to be finalized as the swag track lands.

id
string
required
Example:

"bp_a1b2c3"

title
string
required
media
object[]
required
category
object
required
type
enum<string>
required

Product type. Used both as the value of Product.type and as the filter value for filter[type].

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

"physical"

brand
object

Product brand. May be null (per the parent property) when no brand applies.

Last modified on June 17, 2026