Skip to main content
GET
/
v3
/
base-products
/
{baseProductId}
Get base product by id
curl --request GET \
  --url https://api.snappy.com/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"
  },
  "types": [
    "physical"
  ],
  "brand": {
    "id": "621f9d4b1e675adcbc196159",
    "name": "Apple",
    "description": "Cute pet brand"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.snappy.com/llms.txt

Use this file to discover all available pages before exploring further.

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
types
enum<string>[]
required

Product type. Used both as values of Product.types[] and as filter values for filter[types].

Available options:
physical,
digital,
giftCards,
donations
brand
object

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

Last modified on May 15, 2026