Look up products by ID

Full description

Retrieve products or variants by known ID. Each returned variant includes inputs[] that identifies the requested ID it matched. Unresolved IDs are returned as informational messages instead of a not-found response. Use catalog search for product discovery.

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token presented through Authorization: Bearer $GODADDY_PAT. The PAT must include the scope documented for the operation.

In: header

Header Parameters

Request-Id*string

For tracing the request across network layers and components.

Formatuuid

Request Body

application/json

Request body for catalog lookup.

ids*array<string>

Identifiers to lookup. Implementations MUST support product ID and variant ID; MAY support secondary identifiers (SKU, handle, etc.).

Items1 <= items

filters?

Filter criteria to narrow returned products and variants. All specified filters combine with AND logic.

context?

Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.

signals?

Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.

attribution?

Platform-emitted referral and conversion-event context — campaign identifiers, click IDs, source/medium markers, etc. The same parameters platforms communicate via URL query parameters in browser-based flows.

Response Body

`application/json`

curl -X POST "https://example.com/catalog/lookup" \  -H "Request-Id: 6ba7b810-9dad-41d1-80b4-00c04fd430c8" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "hosting-deluxeapi:1mo"    ],    "context": {      "currency": "USD"    }  }'

{  "ucp": {    "version": "2026-04-08",    "capabilities": {      "dev.ucp.shopping.catalog.lookup": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.input": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_action": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_offer": [        {          "version": "2026-04-08"        }      ]    }  },  "products": [    {      "id": "hosting-deluxeapi",      "title": "Web Hosting Deluxe — Monthly",      "description": {        "plain": "Web Hosting on the Deluxe plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."      },      "categories": [        {          "value": "webHosting"        }      ],      "price_range": {        "min": {          "amount": 1099,          "currency": "USD"        },        "max": {          "amount": 1099,          "currency": "USD"        }      },      "variants": [        {          "id": "hosting-deluxeapi:1mo",          "title": "Web Hosting Deluxe — 1 Month",          "description": {            "plain": "Web Hosting Deluxe, 1-month term."          },          "price": {            "amount": 1099,            "currency": "USD"          },          "list_price": {            "amount": 1099,            "currency": "USD"          },          "availability": {            "available": true          },          "options": [            {              "name": "Term",              "id": "1mo",              "label": "1 Month"            }          ],          "inputs": [            {              "id": "hosting-deluxeapi:1mo",              "match": "exact"            }          ]        }      ]    }  ]}

Last updated on

Look up products by ID

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401

403

404application/json

422application/json

429

`application/json`

`application/json`

`application/json`

`application/json`