find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/buyingmesh-com:buyingmesh-com-merchant-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: BuyingMesh Procurement Merchant 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: Merchant
paths:
  /v1/merchant/applications:
    post:
      operationId: createMerchantApplication
      summary: Submit a merchant onboarding application
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - companyName
              - workEmail
              - contactName
              - category
              - catalogSize
              - shippingOrigin
              - dataAuthorizationConfirmed
              - imageRightsConfirmed
              properties:
                companyName:
                  type: string
                  maxLength: 160
                legalName:
                  type: string
                  maxLength: 200
                workEmail:
                  type: string
                  format: email
                contactName:
                  type: string
                  maxLength: 120
                contactPhone:
                  type: string
                  maxLength: 40
                category:
                  type: string
                  maxLength: 160
                catalogSize:
                  type: string
                  maxLength: 80
                supplierType:
                  type: string
                  enum:
                  - manufacturer
                  - trading_company
                  - distributor
                countryRegion:
                  type: string
                  maxLength: 80
                shippingOrigin:
                  type: string
                  maxLength: 120
                productionCapacity:
                  type: string
                  maxLength: 500
                qualificationSummary:
                  type: string
                  maxLength: 1000
                qualificationEvidenceUrl:
                  type: string
                  format: uri
                  pattern: ^https://
                fulfillmentProfile:
                  type: string
                  maxLength: 1000
                websiteUrl:
                  type: string
                  format: uri
                  pattern: ^https://
                description:
                  type: string
                  maxLength: 1200
                dataAuthorizationConfirmed:
                  type: boolean
                  const: true
                imageRightsConfirmed:
                  type: boolean
                  const: true
      responses:
        '201':
          description: Application received
        '422':
          $ref: '#/components/responses/ValidationError'
      tags:
      - Merchant
  /v1/merchant/products/import:
    post:
      operationId: importMerchantProducts
      summary: Import up to 5,000 private source or merchant product rows for review
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - applicationId
              - products
              properties:
                applicationId:
                  type: string
                  format: uuid
                products:
                  type: array
                  maxItems: 5000
                  items:
                    $ref: '#/components/schemas/MerchantProductImport'
                sourcePlatform:
                  type: string
                  enum:
                  - merchant
                  description: Only supplier-owned or supplier-authorized product data is accepted for onboarding.
                targetCurrency:
                  type: string
                  enum:
                  - USD
                  - CNY
                  default: USD
                markupMultiplier:
                  type: number
                  minimum: 0.01
                  default: 2
                cnyToUsdRate:
                  type: number
                  minimum: 1.0e-06
                  default: 0.138
      responses:
        '201':
          description: Import accepted for review
        '422':
          $ref: '#/components/responses/ValidationError'
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Merchant
  /v1/merchant/products:
    get:
      operationId: listMerchantProducts
      summary: List merchant products
      parameters:
      - name: X-Merchant-Key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Product list
        '401':
          $ref: '#/components/responses/Unauthorized'
      tags:
      - Merchant
    post:
      operationId: createMerchantProduct
      summary: Create a merchant product
      parameters:
      - name: X-Merchant-Key
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Product'
      responses:
        '201':
          description: Product created
        '401':
          $ref: '#/components/responses/Unauthorized'
      tags:
      - Merchant
  /v1/merchant/products/{sku}:
    patch:
      operationId: updateMerchantProduct
      summary: Update merchant-controlled commercial data or product images on an approved SKU
      parameters:
      - name: sku
        in: path
        required: true
        schema:
          type: string
      - name: X-Merchant-Key
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                imageUrls:
                  type: array
                  maxItems: 10
                  description: HTTPS image URLs in display order. An empty array removes all images. Image edits do not require product re-review.
                  items:
                    type: string
                    format: uri
                    pattern: ^https://
                imageRightsConfirmed:
                  type: boolean
                  const: true
                  description: Required when adding or changing to one or more image URLs.
      responses:
        '200':
          description: Product updated; commercial fields and image URL changes are audited
        '401':
          $ref: '#/components/responses/Unauthorized'
      tags:
      - Merchant
components:
  responses:
    ValidationError:
      description: Validation failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Merchant authentication failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  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
    MerchantProductImport:
      type: object
      required:
      - sku
      - title
      - moq
      - price
      - price_currency
      - lead_time_days
      - image_url
      - image_rights_confirmed
      properties:
        sku:
          type: string
        name:
          type: string
          description: Canonical English product name; title is accepted for source exports
        title:
          type: string
          description: Source listing title alias
        material:
          type: string
        材质:
          type: string
        size:
          type: string
        spec:
          type: string
          description: Source specification alias
        规格:
          type: string
        category:
          type: string
        variant:
          type: string
        color:
          type: string
        dimensions:
          type: string
        gtin:
          type: string
        unit_of_measure:
          type: string
        moq:
          type: integer
          minimum: 100
          description: Minimum order quantity in purchasable units
        起订量:
          type: string
        price_amount:
          type: number
          minimum: 0
        price:
          type:
          - number
          - string
          description: Source CNY price alias
        price_currency:
          type: string
          default: CNY
        price_unit:
          type: string
        price_breaks:
          type: array
          items:
            type: object
        inventory:
          type:
          - integer
          - 'null'
          minimum: 0
          description: Optional when inventory_status is unknown
        inventory_status:
          type: string
          enum:
          - confirmed
          - unknown
          default: confirmed
        库存:
          type: string
        lead_time_days:
          type: integer
          minimum: 0
        交期:
          type: string
        shipping_origin:
          type: string
        qualification_status:
          type: string
        qualification_evidence:
          type: string
        source_ref:
          type: string
        image_url:
          type: string
          pattern: ^https://
          description: Public product image URL; multiple URLs may be separated by |
        imageUrl:
          type: string
        images:
          type: string
        image_rights_confirmed:
          type: boolean
          const: true
        last_confirmed_at:
          type: string
          format: date-time
        packaging:
          type: string
        customization:
          type: string
        mixed_batch:
          type: string
        fulfillment_notes:
          type: string
    Product:
      type: object
      required:
      - sku
      - name
      - material
      - size
      - moq
      - minOrderQuantity
      - price
      - inventory
      - leadTimeDays
      - supplierQualifications
      - dataFreshness
      properties:
        '@context':
          type: string
          const: https://schema.org
        '@type':
          type: string
          const: Product
        sku:
          type: string
        gtin:
          type: string
        name:
          type: string
        material:
          type: string
        size:
          type: string
        moq:
          type: integer
          minimum: 100
          description: Minimum order quantity in purchasable units
        minOrderQuantity:
          type: integer
          minimum: 100
          description: Alias of moq
        price:
          type: object
          properties:
            amount:
              type: number
            currency:
              type: string
        inventory:
          type:
          - integer
          - 'null'
          minimum: 0
          description: Null when the latest supplier snapshot has not confirmed stock
        inventoryStatus:
          type: string
          enum:
          - confirmed
          - unknown
        leadTimeDays:
          type: integer
          minimum: 0
        supplierQualifications:
          type: array
          items:
            type: string
        dataFreshness:
          type: string
          format: date-time
        isTestData:
          type: boolean
          deprecated: true
          description: Internal test-data marker. Public catalog responses only contain approved merchant records.
        dataEnvironment:
          type: string
          enum:
          - production
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    adminReviewKey:
      type: apiKey
      in: header
      name: X-Admin-Key