Skip to main content
GET
/
v2
/
collections
/
{collectionId}
/
products
/
{productId}
Get collection product
curl --request GET \
  --url https://api.snappy.com/public-api/v2/collections/{collectionId}/products/{productId} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "string",
  "title": "string",
  "category": "string",
  "brand": {
    "id": "abCd57eFG0",
    "name": "Brand Name",
    "description": "Brand Description"
  },
  "coverImage": {
    "position": 1,
    "type": "image",
    "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
    "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
  },
  "options": {
    "takeYourPick": "Rainbow Bagel Making Kit",
    "color": "Black",
    "size": "S",
    "scent": "Lavender",
    "flavor": "Chocolate",
    "beverageType": "Coffee"
  },
  "tags": [
    {
      "id": "tag12345A",
      "name": "Tag Name",
      "color": "#000000",
      "position": 1
    }
  ],
  "variants": [
    {
      "id": "ab6789cd",
      "optionAttributes": {
        "takeYourPick": "Rainbow Bagel Making Kit",
        "color": "Black",
        "size": "S",
        "scent": "Lavender",
        "flavor": "Chocolate",
        "beverageType": "Coffee"
      },
      "brand": {
        "id": "abCd57eFG0",
        "name": "Brand Name",
        "description": "Brand Description"
      },
      "components": "string",
      "description": "Variant description",
      "features": "Variant features",
      "category": "Electronics / Audio / Headphones / Wireless Earbuds",
      "mediaItems": [
        {
          "position": 1,
          "type": "image",
          "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
          "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
        }
      ],
      "position": 0,
      "types": [
        "digital"
      ],
      "tags": [
        {
          "id": "tag12345A",
          "name": "Tag Name",
          "color": "#000000",
          "position": 1
        }
      ],
      "title": "Variant title",
      "information": {
        "including": "<ul><li>Cute puppy</li></ul>",
        "description": "<p>Cutest puppy in the world</p>",
        "features": "<ul><li>Floppy ears</li><li>Big eyes</li></ul>",
        "specifications": {
          "colorFamily": "Brown",
          "dimensions": "37in x17in 6in",
          "materials": "Cotton",
          "weight": "1.5 lbs"
        }
      },
      "notices": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "pricing": {
        "US": {
          "cost": 100,
          "totalFee": 2,
          "totalTax": 7,
          "totalFinalCost": 109
        }
      },
      "supportedCountries": [
        {
          "countryCode": "US"
        },
        {
          "countryCode": "CA"
        },
        {
          "countryCode": "GB"
        },
        {
          "countryCode": "DE"
        },
        {
          "countryCode": "FR"
        }
      ]
    }
  ],
  "types": [
    "digital"
  ],
  "mediaItems": [
    {
      "position": 1,
      "type": "image",
      "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
      "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
    }
  ],
  "notices": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}

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

Company Level Authentication

Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.

Getting Your API Key

  1. Create an API Key: Use the POST /v2/authentication/apiKeys endpoint to generate a new API key
  2. Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
  3. Optional mTLS: Enable mutual TLS for enhanced security
  4. Name Your Key: Provide a descriptive name for easy identification

Using Your API Key

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

X-Api-Key: YOUR_24_CHARACTER_API_KEY

API Key Management

  • Maximum Keys: Up to 3 active API keys per company
  • Rotation: Delete old keys before creating new ones when at the limit
  • Security: Keys are hashed and cannot be retrieved after creation

Enhanced Security (mTLS)

For production environments, enable mutual TLS authentication:

  1. Set enforceMtls: true when creating the API key
  2. Contact support to obtain your client certificates
  3. Use the mTLS endpoint: https://mtls-api.snappy.com/public-api

Headers

​
Request-Source
enum<string>

Source of the request

Available options:
api_native,
api_zapier,
api_salesforce,
api_ftp,
api_make
Example:

"api_native"

Path Parameters

​
collectionId
string
required

Collection ID.

Pattern: ^[A-Za-z0-9]{8,}$
Example:

"abcdef12"

​
productId
string
required

Product ID.

Pattern: ^[A-Za-z0-9]{8,}$
Example:

"ab1234cd"

Query Parameters

​
minBudget
number

Minimum budget

Required range: 1 <= x <= 20000
Example:

1

​
maxBudget
number

Maximum budget

Required range: 1 <= x <= 20000
Example:

10000

​
companyId
string

Company ID

Pattern: ^[A-Za-z0-9]{8,}$
Example:

"12345678"

​
country
string
default:US
​
accountId
string

Account ID

Example:

"a12bcd34"

​
fields
enum<string>[]

List of additional fields to include in response objects

Minimum array length: 1

The fields to return additionally in response. Valid values are: mediaItems, tags, brand, optionAttributes, notices, pricing, supportedCountries, full.

Available options:
mediaItems,
tags,
brand,
optionAttributes,
notices,
pricing,
supportedCountries,
full
Example:
["full"]

Response

Successful response

Response containing product with variants.

​
id
string

Product ID

Example:

"abc12345"

​
title
string

Product title

Example:

"Product Title"

​
category
string

Product category

Example:

"Electronics"

​
brand
object

Brand information for a product.

Example:
{
  "id": "abCd57eFG0",
  "name": "Brand Name",
  "description": "Brand Description"
}
​
coverImage
object

Media item for a product.

Example:
{
  "position": 1,
  "type": "image",
  "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
  "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
}
​
options
object

Product options and attributes.

Example:
{
  "takeYourPick": "Rainbow Bagel Making Kit",
  "color": "Black",
  "size": "S",
  "scent": "Lavender",
  "flavor": "Chocolate",
  "beverageType": "Coffee"
}
​
tags
object[]

Product tags

​
variants
object[]

Product variants

​
types
enum<string>[]

Product types

The type of product.

Available options:
digital,
physical,
base-product-swag,
on-demand-swag,
on-demand-plus-swag,
premium-swag,
experience,
personalized
​
mediaItems
object[]

Product media items

​
notices
object

Product notices

Example:
{
  "shipping": "Ships within 3-5 business days",
  "warranty": "1 year warranty"
}
Last modified on April 16, 2026