---
title: "Search structured products"
method: GET
path: "/v1/products"
---

# Search structured products

`GET /v1/products`

## Request

- Base URL: `https://buyingmesh.com`
- URL: `https://buyingmesh.com/v1/products`
- Auth: none declared

## Query parameters

- `q` string
- `sku` string
- `gtin` string
- `category` string
- `supplierId` string
- `supplierSlug` string
- `material` string
- `size` string
- `minMoq` integer
- `maxMoq` integer
- `minPrice` number
- `maxPrice` number, double
- `currency` string
- `minInventory` integer
- `inventoryStatus` 'confirmed' | 'unknown'
- `maxLeadTimeDays` integer
- `qualificationStatus` string
- `verifiedOnly` boolean
- `freshnessWithinMinutes` integer
- `environment` 'production'
- `cursor` string
- `limit` integer

## Response `200`

Product results

- ApiProductSearchResponse
  - `status` 'ok', required
  - `data` ProductSearchResponse, required
    - `items` Product[], required
      - `@context` 'https://schema.org'
      - `@type` 'Product'
      - `sku` string, required
      - `gtin` string
      - `name` string, required
      - `material` string, required
      - `size` string, required
      - `moq` integer, required: Minimum order quantity in purchasable units
      - `minOrderQuantity` integer, required: Alias of moq
      - `price` object, required
        - `amount` number
        - `currency` string
      - `inventory` integer, nullable, required: Null when the latest supplier snapshot has not confirmed stock
      - `inventoryStatus` 'confirmed' | 'unknown'
      - `leadTimeDays` integer, required
      - `supplierQualifications` string[], required
      - `dataFreshness` string, date-time, required
      - `isTestData` boolean: Internal test-data marker. Public catalog responses only contain approved merchant records.
      - `dataEnvironment` 'production'
    - `nextCursor` string, nullable, required
    - `queryCost` object, required
      - `amount` string
      - `currency` string
  - `error` unknown, required

## Other responses

- `402`: An x402 payment is required for this query

---

[API](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api.md) · [All operations](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api/revisions/370360c1315c?raw)