GET
/
v1
/
products
List all active products
curl --request GET \
  --url https://api.ongoody.com/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "0a13b319-3d70-408a-9aa3-056f8c0a292d",
      "name": "Cookie Box",
      "brand": {
        "id": "fcbece72-77fb-4e9e-ab13-8dd29633a6cc",
        "name": "Edwina Hansen",
        "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": "324c7cba-20e7-45c1-8270-698ced004c8d",
          "name": "Grey / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "a7cc729f-153a-427a-908a-b91a8c6dd0f1",
          "name": "Grey / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "b98561ea-bcdd-43ee-8c28-9a1a17441f67",
          "name": "Grey / Sugar",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "db935df0-38f5-412d-a5c4-2ebfa96dcab3",
          "name": "Purple / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "b5571146-438f-4f0d-8b4d-51765357d917",
          "name": "Purple / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "fd8c973d-3d11-4a5f-a087-2b4673145a07",
          "name": "Purple / Sugar",
          "subtitle": null,
          "image_large": null
        }
      ],
      "variant_groups": [
        {
          "id": "d1fca19e-5324-448c-b383-97582d4a22f2",
          "name": "Box Color",
          "options": [
            {
              "id": "87176db9-bca7-43d3-86a3-6d16446a4f9d",
              "name": "Grey",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "3b4a5d52-4746-41a3-9c05-078e694d9610",
              "name": "Purple",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        },
        {
          "id": "ffa23961-fcb1-438c-9ea3-87563e38dce9",
          "name": "Flavor",
          "options": [
            {
              "id": "29cbdfc0-0459-44d6-9a63-1b0516c6d344",
              "name": "Chocolate Chip",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "b1f488f2-98f9-4162-89b3-0433d546db51",
              "name": "Oatmeal",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "c8ad36d2-1d5f-4d05-9a77-7083173bd329",
              "name": "Sugar",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        }
      ],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-09-12T22:41:19Z",
      "status": "active"
    },
    {
      "id": "7d292d2c-9de9-4795-9e55-42691d91fd84",
      "name": "Six Cookies",
      "brand": {
        "id": "fcbece72-77fb-4e9e-ab13-8dd29633a6cc",
        "name": "Edwina Hansen",
        "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": "9cac3911-8421-47ec-8044-71e06502f23e",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "2e9124c5-c0d6-478b-a711-db25c6b0ea5b",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "b26813cc-a28a-4c17-bc91-a30618442e1a",
          "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-09-12T22:41:19Z",
      "status": "active"
    },
    {
      "id": "f000d8d5-de0b-4b8b-8bee-017128370b8e",
      "name": "Dozen Cookies",
      "brand": {
        "id": "fcbece72-77fb-4e9e-ab13-8dd29633a6cc",
        "name": "Edwina Hansen",
        "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": "5c676bef-cd65-4e0e-9707-f05567bd38ad",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "2ab5cbea-211b-4d0f-b665-adec534df3b5",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "dca0288e-5775-447f-bc3b-81f148d708ee",
          "name": "Sugar",
          "subtitle": "Tasty sugar.",
          "image_large": null
        }
      ],
      "variant_groups": [],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-09-12T22:41: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