Get Product Category

Retrieve a specific product category by its ID.

Path Parameters

  • site_namerequired
  • product_category_idrequired

Query Parameters

    Authentication Header

    • x-api-keyrequired
    ENDPOINT
    GET /v1/{site_name}/product_category/{product_category_id}
    RESPONSE BODY
    {
      "slug": "gbv-albums",
      "media": [
        {
          "link": "https://gbvmusicstore.com/category/gbv-albums-cover.jpg",
          "size": "800x800",
          "title": "GBV Albums Collection",
          "width": 800,
          "height": 800,
          "caption": "Guided by Voices Albums Collection",
          "filesize": 204800,
          "media_id": 300,
          "file_name": "gbv-albums-cover.jpg",
          "site_name": "GBV Music Store",
          "media_date": "2024-03-15T00:00:00Z",
          "description": "Explore the legendary discography of Guided by Voices.",
          "is_original": true,
          "content_type": "image/jpeg",
          "is_thumbnail": true,
          "original_url": "https://gbvmusicstore.com/category/gbv-albums-cover.jpg",
          "attachment_id": 400
        }
      ],
      "category": "Guided by Voices Albums",
      "products": [
        {
          "slug": "gbv-bee-thousand-vinyl",
          "media": [
            {
              "link": "https://gbvstore.com/media/bee-thousand-vinyl.jpg",
              "size": "500x500",
              "title": "Bee Thousand Vinyl Cover",
              "width": 500,
              "height": 500,
              "caption": "Front cover of Bee Thousand vinyl.",
              "filesize": 102400,
              "media_id": 100,
              "file_name": "bee-thousand-vinyl.jpg",
              "site_name": "GBV Official Store",
              "media_date": "2024-03-20T00:00:00Z",
              "description": "Bee Thousand album cover art.",
              "is_original": true,
              "content_type": "image/jpeg",
              "is_thumbnail": false,
              "original_url": "https://gbvstore.com/media/bee-thousand-vinyl.jpg",
              "attachment_id": 200
            }
          ],
          "order": 1,
          "price": 25,
          "product": "Guided by Voices - Bee Thousand Vinyl",
          "currency": "USD",
          "variants": [],
          "product_id": 1,
          "description": "A reissue of the classic 1994 album 'Bee Thousand' by Guided by Voices on high-quality vinyl. Includes a digital download code.",
          "unit_amount": 1,
          "product_date": "2024-03-20T00:00:00Z",
          "product_modified": "2024-03-21T00:00:00Z",
          "quantity_available": 100,
          "stripe_description": "GBV Bee Thousand Vinyl",
          "product_category_id": 1,
          "stripe_product_id_live": "prod_live_1234",
          "stripe_product_id_test": "prod_test_5678"
        },
        {
          "slug": "gbv-alien-lanes-le-vinyl",
          "media": [],
          "order": 2,
          "price": 30,
          "product": "Guided by Voices - Alien Lanes Limited Edition Vinyl",
          "currency": "USD",
          "variants": [],
          "product_id": 2,
          "description": "Limited edition pressing of 'Alien Lanes' by Guided by Voices. Features colored vinyl and exclusive artwork.",
          "unit_amount": 1,
          "product_date": "2024-03-22T00:00:00Z",
          "product_modified": "2024-03-23T00:00:00Z",
          "quantity_available": 50,
          "stripe_description": "GBV Alien Lanes LE Vinyl",
          "product_category_id": 1,
          "stripe_product_id_live": "prod_live_2345",
          "stripe_product_id_test": "prod_test_6789"
        }
      ],
      "site_name": "GBV Music Store",
      "category_id": 1,
      "description": "Explore our collection of Guided by Voices albums, from classic releases to the latest hits. Each vinyl comes with a unique digital download code.",
      "slug_prefix": "music"
    }
    RESPONSE STATUS CODE
    200