BuyingMesh Suppliers API

openapi: 3.2.0
info:
  title: BuyingMesh Procurement Suppliers API
  version: 0.5.4
  description: Structured supplier and product API for buying agents. Product discovery exposes reviewed merchant listings with explicit price, lead-time and inventory evidence; the current public catalog contains 86 approved production SKUs from one reviewed supplier and reports confirmed inventory in the current snapshot. Read each SKU inventoryStatus and dataFreshness before quoting. x402 payments and real order creation are disabled until production settlement and fulfillment are ready. All REST responses use the JSON envelope {status, data, error}; MCP remains JSON-RPC. Merchant applications are open now.
servers:
- url: https://buyingmesh.com
tags:
- name: Suppliers
paths:
  /v1/suppliers:
    get:
      operationId: searchSuppliers
      summary: Search approved public supplier storefronts
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: countryRegion
        in: query
        schema:
          type: string
      - name: supplierType
        in: query
        schema:
          type: string
      - name: verified
        in: query
        schema:
          type: boolean
      - name: minProducts
        in: query
        schema:
          type: integer
          minimum: 0
      - name: cursor
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      responses:
        '200':
          description: Public supplier storefronts with reviewed credentials and platform-observed performance summaries
      tags:
      - Suppliers
  /v1/suppliers/{supplierId}:
    get:
      operationId: getSupplier
      summary: Get a public supplier storefront by stable ID or slug
      parameters:
      - name: supplierId
        in: path
        required: true
        description: Stable supplier ID or public slug
        schema:
          type: string
      responses:
        '200':
          description: Supplier profile
          public credentials: null
          catalog counts and performance summary: null
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Suppliers
  /v1/suppliers/{supplierId}/performance:
    get:
      operationId: getSupplierPerformance
      summary: Get platform-observed supplier fulfillment performance
      parameters:
      - name: supplierId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Supplier performance summary with sample size and as-of timestamp
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Suppliers
  /v1/suppliers/{supplierId}/products:
    get:
      operationId: listSupplierProducts
      summary: Search the approved production catalog for one supplier
      parameters:
      - name: supplierId
        in: path
        required: true
        schema:
          type: string
      - name: sku
        in: query
        description: Exact SKU match
        schema:
          type: string
      - name: gtin
        in: query
        description: Exact GTIN match
        schema:
          type: string
      - name: q
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: material
        in: query
        schema:
          type: string
      - name: size
        in: query
        schema:
          type: string
      - name: minMoq
        in: query
        schema:
          type: integer
          minimum: 1
      - name: maxMoq
        in: query
        schema:
          type: integer
          minimum: 1
      - name: minPrice
        in: query
        schema:
          type: number
          minimum: 0
      - name: maxPrice
        in: query
        schema:
          type: number
          minimum: 0
      - name: minInventory
        in: query
        schema:
          type: integer
          minimum: 0
      - name: maxLeadTimeDays
        in: query
        schema:
          type: integer
          minimum: 0
      - name: verifiedOnly
        in: query
        schema:
          type: boolean
      - name: cursor
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      responses:
        '200':
          description: Exact supplier SKU search and paginated product records
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Suppliers
components:
  schemas:
    Error:
      type: object
      required:
      - status
      - data
      - error
      properties:
        status:
          type: string
          const: error
        data:
          type: 'null'
        error:
          type: object
          required:
          - code
          - message
          - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    adminReviewKey:
      type: apiKey
      in: header
      name: X-Admin-Key