GET
/
v1
/
products
curl --request GET \
  --url https://api.ongoody.com/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "4e151244-90c2-402f-b4aa-3335110ae0ba",
      "name": "Six Cookies",
      "brand": {
        "id": "1a286c1e-e2aa-40cc-bd91-77c7426de3b7",
        "name": "Lakia Reichel LLD",
        "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": "1c0e26b6-b18e-4a35-89a3-dc50c2024a19",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "13b6e322-6d61-42e3-8ca2-59e1132c4107",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "14ec84df-8e33-415b-8ec8-d47208f31e9a",
          "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-05-18T05:07:40Z",
      "status": "active"
    },
    {
      "id": "82083ccc-19f4-480b-9262-c17360106569",
      "name": "Dozen Cookies",
      "brand": {
        "id": "1a286c1e-e2aa-40cc-bd91-77c7426de3b7",
        "name": "Lakia Reichel LLD",
        "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": "c50c7517-6600-4af4-bd23-7765d7442b98",
          "name": "Chocolate Chip",
          "subtitle": "Classic chocolate chip.",
          "image_large": null
        },
        {
          "id": "97678dab-c70a-4522-ab41-f24158e8e422",
          "name": "Oatmeal",
          "subtitle": "Delicious oatmeal.",
          "image_large": null
        },
        {
          "id": "e46b9cf9-6551-427a-b349-dc475e115980",
          "name": "Sugar",
          "subtitle": "Tasty sugar.",
          "image_large": null
        }
      ],
      "variant_groups": [],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-05-18T05:07:40Z",
      "status": "active"
    },
    {
      "id": "a94939cf-4af4-4007-accd-a16807f7974c",
      "name": "Cookie Box",
      "brand": {
        "id": "1a286c1e-e2aa-40cc-bd91-77c7426de3b7",
        "name": "Lakia Reichel LLD",
        "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": "a0257735-de49-420a-89e7-99337ffffdf2",
          "name": "Grey / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "cbe57e10-efc6-4cdc-a06d-f026333cc59e",
          "name": "Grey / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "43d42703-b48f-40fa-a9f3-e1d1b2ca9ea7",
          "name": "Grey / Sugar",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "288fba29-2d53-4a6a-9606-ce8287e58bf2",
          "name": "Purple / Chocolate Chip",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "581f9128-0a94-4303-b848-5f0463d9f5e9",
          "name": "Purple / Oatmeal",
          "subtitle": null,
          "image_large": null
        },
        {
          "id": "5461af37-22c3-45c4-9d1b-402fe0b51fa7",
          "name": "Purple / Sugar",
          "subtitle": null,
          "image_large": null
        }
      ],
      "variant_groups": [
        {
          "id": "5294a9b4-67c1-4711-a7f0-e917587737a8",
          "name": "Box Color",
          "options": [
            {
              "id": "365b3ff4-e76e-480a-b159-3ddf64cd32e3",
              "name": "Grey",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "97fa4ef6-4fa4-48d0-8b01-93a8351b3b82",
              "name": "Purple",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        },
        {
          "id": "5366d8aa-ff10-45e6-b751-e2d332d21f4c",
          "name": "Flavor",
          "options": [
            {
              "id": "fc84a3b4-dcd7-4429-b6bf-b0aa608780a7",
              "name": "Chocolate Chip",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "42315ca4-7618-4c85-8245-b3ca42fa842e",
              "name": "Oatmeal",
              "subtitle": null,
              "color": null,
              "image_large": null
            },
            {
              "id": "19b25e7d-3275-4382-b3e7-b29e11b85d12",
              "name": "Sugar",
              "subtitle": null,
              "color": null,
              "image_large": null
            }
          ]
        }
      ],
      "images": [],
      "price": 1000,
      "price_is_variable": false,
      "restricted_states": [],
      "attributes": [],
      "updated_at": "2025-05-18T05:07:40Z",
      "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

The response is of type object.