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": "83bd1170-9352-427d-85aa-e2bcf3c323c8",
      "name": "Six Cookies",
      "brand": {
        "id": "2a294fe7-ecac-40c2-ae3f-1c931ae68720",
        "name": "Nerissa Littel",
        "logo_image": null,
        "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": "5dea5349-cf6c-4b67-8ace-309557f16f9f",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "7324cbd9-0c83-4d79-90ec-c793ab0023af",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "928b21ea-a7a3-4ad2-aa6c-f30b23f10faa",
          "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": "2026-06-03T12:25:19Z",
      "status": "active"
    },
    {
      "id": "94d0582f-f37b-45e4-b4d6-188ddd41e499",
      "name": "Dozen Cookies",
      "brand": {
        "id": "2a294fe7-ecac-40c2-ae3f-1c931ae68720",
        "name": "Nerissa Littel",
        "logo_image": null,
        "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": "d63f8e89-a7cb-4607-8f8b-1f347be4d1b6",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "b197404c-c331-4676-8580-290b2bebe353",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "1e2c60a4-6513-48a6-a696-021e5c2d3093",
          "name": "Sugar",
          "subtitle": "Tasty sugar.",
          "image_large": null
        }
      ],
      "variant_groups": [],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2026-06-03T12:25:19Z",
      "status": "active"
    },
    {
      "id": "a169b309-6166-4382-b020-8d571c7f2b95",
      "name": "Cookie Box",
      "brand": {
        "id": "2a294fe7-ecac-40c2-ae3f-1c931ae68720",
        "name": "Nerissa Littel",
        "logo_image": null,
        "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": "badeeb1c-8847-40d9-b7f9-d118723f51f1",
          "name": "Grey / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "01f20566-5645-4c32-9f79-222c5c1f1407",
          "name": "Grey / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "b7fc2aad-b490-47af-b73f-7cc5aa55697a",
          "name": "Grey / Sugar",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "72f5b1fb-5085-4218-8c60-a356d35b3be1",
          "name": "Purple / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "2ec977b6-4333-4e20-a8dc-dca2cc27fb6d",
          "name": "Purple / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "2a060efb-a11e-4858-a547-939ca630977c",
          "name": "Purple / Sugar",
          "subtitle": null,
          "image_large": null
        }
      ],
      "variant_groups": [
        {
          "id": "6dba80e5-2bd7-49fe-bffb-7739c0574d48",
          "name": "Box Color",
          "options": [
            {
              "id": "b24e07dc-bc75-4425-83fa-4d212e83114a",
              "name": "Grey",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "1a7794e5-95cc-4308-a1f0-48925271e49c",
              "name": "Purple",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        },
        {
          "id": "4f2acf33-9f5d-4117-b3f4-8eb82517bc07",
          "name": "Flavor",
          "options": [
            {
              "id": "e849793c-c0d3-409a-b915-bbce6be5b37c",
              "name": "Chocolate Chip",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "5f22280f-64e7-4d8c-a42a-1030e2153b77",
              "name": "Oatmeal",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "e8323403-4ba5-4893-b747-969a4bc2259e",
              "name": "Sugar",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        }
      ],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2026-06-03T12:25:19Z",
      "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