01.software Docs

getListingGroupsQuery

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/query

GET uses CSV sort and JSON whereJson, not the POST body; full server-only projection.

Authorization

publishableKeybearerAuth
headerX-Publishable-Key<token>

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

headerAuthorizationBearer <token>

Public integration credentials: verified opaque sk01_ secret key or pat01_ personal access token; operation policy and read/write scopes still apply. These credentials are not Customer JWTs.

Query Parameters

locale?string
Value in"ko""en""all"
fallbackLocale?string
Value in"ko""en""none""false"
market?string
Length1 <= length
page?integer
Range1 <= value
limit?integer
Range1 <= value <= 100
sort?string

One allowed ListingPublicSort field or CSV of 1–5 fields; optional - prefix.

whereJson?string

JSON-encoded ListingPublicWhere; invalid JSON/nonempty operators/recursive and-or constraints are rejected.

Response Body

Actual shaped success body

application/json
  1. response
docs*array<>
totalDocs*number
limit*number
totalPages*number
page*number
pagingCounter*number
hasPrevPage*boolean
hasNextPage*boolean
prevPage*number|null
nextPage*number|null

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/query'
Example Response
{  "docs": [    {      "product": {        "id": "string",        "createdAt": "string",        "updatedAt": "string",        "slug": "string",        "title": "string",        "status": "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",              "stock": 0            }          ]        }      },      "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",              "stock": 0            }          ],          "listing": {            "selectionHintVariant": "string",            "primaryImage": "string",            "minPrice": 0,            "maxPrice": 0,            "minCompareAtPrice": 0,            "maxCompareAtPrice": 0,            "isPriceRange": true,            "availableForSale": true          }        }      ]    }  ],  "totalDocs": 0,  "limit": 0,  "totalPages": 0,  "page": 0,  "pagingCounter": 0,  "hasPrevPage": true,  "hasNextPage": true,  "prevPage": 0,  "nextPage": 0}