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-inquiries-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 Inquiries 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: Inquiries
paths:
  /v1/inquiries:
    post:
      operationId: submitInquiry
      summary: Submit a structured, non-binding supplier inquiry
      description: Sends SKU, quantity, destination, buyer and agent context to the responsible merchant. An inquiry can be submitted while inventory is unknown; it does not create an order, reserve inventory or move money. Reuse the Idempotency-Key header to safely retry.
      parameters:
      - $ref: '#/components/parameters/IdempotencyKeyOptional'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InquiryRequest'
      responses:
        '202':
          description: Inquiry stored and supplier notification attempted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InquiryEnvelope'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/ValidationError'
      tags:
      - Inquiries
  /v1/inquiries/{inquiryId}:
    get:
      operationId: getInquiry
      summary: Read inquiry status and supplier notification delivery
      parameters:
      - name: inquiryId
        in: path
        required: true
        schema:
          type: string
          pattern: ^inq_
      responses:
        '200':
          description: Inquiry record and notification status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InquiryEnvelope'
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Inquiries
components:
  parameters:
    IdempotencyKeyOptional:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        minLength: 8
        maxLength: 180
  schemas:
    InquiryEnvelope:
      type: object
      required:
      - status
      - data
      - error
      properties:
        status:
          type: string
          const: ok
        data:
          type: object
          required:
          - inquiryId
          - status
          - items
          - notifications
          properties:
            inquiryId:
              type: string
              pattern: ^inq_
            status:
              type: string
              const: submitted
            items:
              type: array
              items:
                type: object
            destination:
              type: object
            buyer:
              type: object
            agent:
              type:
              - object
              - 'null'
            notifications:
              type: array
              items:
                type: object
            notificationStatus:
              type: string
              enum:
              - delivered
              - partial
              - failed
            nextStep:
              type: string
        error:
          type: 'null'
    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
    InquiryRequest:
      type: object
      required:
      - items
      - destination
      - buyer
      properties:
        items:
          type: array
          minItems: 1
          maxItems: 50
          items:
            type: object
            required:
            - sku
            - quantity
            properties:
              sku:
                type: string
                maxLength: 120
              quantity:
                type: integer
                minimum: 1
                maximum: 1000000000
              note:
                type: string
                maxLength: 300
        destination:
          type: object
          required:
          - country
          properties:
            country:
              type: string
              maxLength: 80
            city:
              type: string
              maxLength: 120
            region:
              type: string
              maxLength: 120
            postalCode:
              type: string
              maxLength: 40
        buyer:
          type: object
          required:
          - email
          properties:
            email:
              type: string
              format: email
            company:
              type: string
              maxLength: 200
            name:
              type: string
              maxLength: 120
        agent:
          type: object
          properties:
            id:
              type: string
              maxLength: 180
            name:
              type: string
              maxLength: 180
            version:
              type: string
              maxLength: 80
        message:
          type: string
          maxLength: 2000
        idempotencyKey:
          type: string
          maxLength: 180
  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'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    adminReviewKey:
      type: apiKey
      in: header
      name: X-Admin-Key