Skip to main content
GET
/
v1
/
products
List all active products
curl --request GET \
  --url https://api.ongoody.com/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "71b27de6-11b7-46e3-a064-2dfef6fa3964",
      "name": "Cookie Box",
      "brand": {
        "id": "ecdf1cfc-474a-43a0-9cc9-ea24aed54c82",
        "name": "Page Deckow",
        "shipping_price": 1000,
        "free_shipping_minimum": null,
        "brand_values": [
          "Sustainable"
        ]
      },
      "subtitle": null,
      "subtitle_short": null,
      "recipient_description": "",
      "variants_label": "option",
      "variants_num_selectable": 1,
      "variants": [
        {
          "id": "72ebd34f-3a1d-4f4e-a479-926a9f9f153b",
          "name": "Grey / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "edf28155-2db2-42e4-9342-685d277a5f0a",
          "name": "Grey / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "3628bd8e-27cb-46e1-a3f4-11e60568baaa",
          "name": "Grey / Sugar",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "1775b9ff-b293-43c9-8350-c738064a3454",
          "name": "Purple / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "29393250-1338-4ca1-8655-5b900de91f2d",
          "name": "Purple / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "fd59f83b-0bce-4700-81a0-75404e3f54dd",
          "name": "Purple / Sugar",
          "subtitle": null,
          "image_large": null
        }
      ],
      "variant_groups": [
        {
          "id": "0ed018fc-a7f3-4d0b-b363-0581aeada3de",
          "name": "Box Color",
          "options": [
            {
              "id": "c76cff37-c982-4ef3-8a79-9a6c25feaaf0",
              "name": "Grey",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "abaa14ad-48a3-4e9d-8cdd-5f0dc1f41217",
              "name": "Purple",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        },
        {
          "id": "cf7fc9e5-1cd1-4ca9-8b7c-400ca692c7e7",
          "name": "Flavor",
          "options": [
            {
              "id": "62c6051a-6905-4c3a-a212-31406200f6e5",
              "name": "Chocolate Chip",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "6dba6138-44a8-46ab-aa8a-e4937af00bb8",
              "name": "Oatmeal",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "537ad1be-aaf2-4a5a-9d09-7d4223ea848b",
              "name": "Sugar",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        }
      ],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-12-30T00:51:09Z",
      "status": "active"
    },
    {
      "id": "9199a533-9ab5-4e4c-b406-28cf08f125f2",
      "name": "Dozen Cookies",
      "brand": {
        "id": "ecdf1cfc-474a-43a0-9cc9-ea24aed54c82",
        "name": "Page Deckow",
        "shipping_price": 1000,
        "free_shipping_minimum": null,
        "brand_values": [
          "Sustainable"
        ]
      },
      "subtitle": null,
      "subtitle_short": null,
      "recipient_description": "",
      "variants_label": "option",
      "variants_num_selectable": 3,
      "variants": [
        {
          "id": "cf9acc4f-0a99-42c5-8ff6-f9d2920deabc",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "a81dea3a-e548-46cc-9761-49256197398c",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "13ec8494-436d-4f40-899b-6f09f57eea3c",
          "name": "Sugar",
          "subtitle": "Tasty sugar.",
          "image_large": null
        }
      ],
      "variant_groups": [],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-12-30T00:51:09Z",
      "status": "active"
    },
    {
      "id": "af1ae7b3-6105-4ad0-951b-08aff124930a",
      "name": "Six Cookies",
      "brand": {
        "id": "ecdf1cfc-474a-43a0-9cc9-ea24aed54c82",
        "name": "Page Deckow",
        "shipping_price": 1000,
        "free_shipping_minimum": null,
        "brand_values": [
          "Sustainable"
        ]
      },
      "subtitle": null,
      "subtitle_short": null,
      "recipient_description": "",
      "variants_label": "option",
      "variants_num_selectable": 3,
      "variants": [
        {
          "id": "9bf0b54c-f37f-4ffa-b603-b10fe8ae466b",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "2c1c7462-a14d-4ccb-881e-599367ebab47",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "24fb8fc1-0274-4293-8c48-6e538928c025",
          "name": "Sugar",
          "subtitle": "Tasty sugar.",
          "image_large": null
        }
      ],
      "variant_groups": [],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [
        {
          "label": "Where it's made",
          "content": "Made in Miami, FL"
        }
      ],
      "updated_at": "2025-12-30T00:51:09Z",
      "status": "active"
    }
  ],
  "list_meta": {
    "total_count": 3
  }
}

Authorizations

Authorization
string
header
required

Your Goody API key.

Query Parameters

page
integer
default:1

Page for pagination, starting at 1

Required range: x >= 1
per_page
integer
default:20

Items per page for pagination

Required range: 1 <= x <= 100
use_custom_catalog
boolean

Limit to custom catalog only (for approved API partners)

country_code
string
default:US

Filter by a specific shipping country code

custom_catalog_show_inactive
boolean

Show inactive products in the custom catalog. Only for Commerce API customers with a custom catalog.

Response

200 - application/json

Products retrieved

data
object[]
list_meta
object