01.software Docs

getListingGroupsCatalog

Use the SDK for application integration. This read-only reference covers Commerce, Customer Auth, Membership and Events.

All HTTP operations
GET
/api/products/listing-groups/catalog

Public published catalog projection by IDs, preserving docs/missing and caller ID order.

Authorization

publishableKey
headerX-Publishable-Key<token>

Tenant publishable key for authentication (sent via X-Publishable-Key header)

Query Parameters

ids*string

CSV IDs, trimmed, empty entries ignored; 1–100 resulting IDs.

Length1 <= length
locale?string
Value in"ko""en""all"
fallbackLocale?string
Value in"ko""en""none""false"
market?string
Length1 <= length

Response Body

Actual shaped success body

application/json
  1. response
docs*array<>
missing*array<string>

Examples may be generated from schemas; they are illustrative, not recorded successful API calls. Example snippets may omit required authentication headers.

Example Request
curl -X GET 'https://api.01.software/api/products/listing-groups/catalog?ids=string'
Example Response
{  "docs": [    {      "product": {        "id": "string",        "slug": "string",        "handle": "string",        "title": "string",        "subtitle": "string",        "images": [          "string"        ],        "featuredImage": "string",        "priceRange": {          "minVariantPrice": {            "amount": 0          },          "maxVariantPrice": {            "amount": 0          },          "isPriceRange": true        },        "compareAtPriceRange": {          "minVariantPrice": {            "amount": 0          },          "maxVariantPrice": {            "amount": 0          }        },        "availableForSale": true,        "selectedOrFirstAvailableVariant": "string",        "variants": {          "docs": [            {              "id": "string",              "optionValues": [                "string"              ],              "price": 0,              "compareAtPrice": 0,              "resolvedPrice": {                "amount": 0,                "compareAtPrice": 0,                "currency": "string",                "marketId": "string",                "source": "fixed"              },              "isUnlimited": true,              "inventoryPolicy": "deny",              "isActive": true,              "thumbnail": "string",              "images": [                "string"              ],              "_order": "string"            }          ]        }      },      "groups": [        {          "optionId": "string",          "optionTitle": "string",          "optionValueId": "string",          "optionValueLabel": "string",          "optionValueSlug": "string",          "optionValueSwatch": {            "type": "color",            "color": "string",            "mediaItemId": null          },          "variantIds": [            "string"          ],          "variantCount": 0,          "variants": [            {              "id": "string",              "optionValues": [                "string"              ],              "price": 0,              "compareAtPrice": 0,              "resolvedPrice": {                "amount": 0,                "compareAtPrice": 0,                "currency": "string",                "marketId": "string",                "source": "fixed"              },              "isUnlimited": true,              "inventoryPolicy": "deny",              "isActive": true,              "thumbnail": "string",              "images": [                "string"              ],              "_order": "string"            }          ],          "listing": {            "selectionHintVariant": "string",            "primaryImage": "string",            "minPrice": 0,            "maxPrice": 0,            "minCompareAtPrice": 0,            "maxCompareAtPrice": 0,            "isPriceRange": true,            "availableForSale": true          }        }      ]    }  ],  "missing": [    "string"  ]}