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-orders-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 Orders 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: Orders
paths:
  /v1/orders:
    post:
      operationId: createOrder
      summary: Create a B2B procurement order
      parameters:
      - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrderRequest'
      responses:
        '201':
          description: Order confirmed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiOrderResponse'
        '422':
          $ref: '#/components/responses/ValidationError'
      tags:
      - Orders
  /v1/orders/{orderId}:
    get:
      operationId: getOrder
      summary: Get order and latest fulfillment status
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Order detail
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiOrderResponse'
        '404':
          $ref: '#/components/responses/NotFound'
      tags:
      - Orders
  /v1/orders/{orderId}/status:
    post:
      operationId: transitionOrder
      summary: Advance the order state machine
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - status
              properties:
                status:
                  type: string
                  enum:
                  - shipped
                  - tracking_updated
                  - eta_updated
                  - delivered
                  - accepted
                  - released
                  - disputed
                  - cancelled
                data:
                  type: object
      responses:
        '200':
          description: Status advanced
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiOrderResponse'
        '409':
          $ref: '#/components/responses/Conflict'
      tags:
      - Orders
  /v1/orders/{orderId}/cancel:
    post:
      operationId: cancelOrder
      summary: Cancel an order while its current state allows cancellation
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                reason:
                  type: string
                  maxLength: 500
      responses:
        '200':
          description: Cancelled order
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiOrderResponse'
        '409':
          $ref: '#/components/responses/Conflict'
      tags:
      - Orders
  /v1/orders/{orderId}/tracking:
    post:
      operationId: attachTracking
      summary: Attach tracking and trigger a tracking sync
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - carrier
              - trackingNumber
              properties:
                carrier:
                  type: string
                  enum:
                  - kuaidi100
                  - 17track
                  - other
                provider:
                  type: string
                  description: Provider adapter. Defaults to carrier.
                carrierCode:
                  type: string
                  description: Optional carrier code used by the provider.
                trackingNumber:
                  type: string
      responses:
        '202':
          description: Async sync accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
      tags:
      - Orders
  /v1/orders/{orderId}/tracking/sync:
    post:
      operationId: syncTracking
      summary: Refresh shipment events and ETA from the configured carrier adapter
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '202':
          description: Tracking sync accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
        '409':
          $ref: '#/components/responses/Conflict'
      tags:
      - Orders
components:
  schemas:
    ApiOrderResponse:
      type: object
      required:
      - status
      - data
      - error
      properties:
        status:
          type: string
          const: ok
        data:
          $ref: '#/components/schemas/Order'
        error:
          type: 'null'
    Order:
      type: object
      required:
      - id
      - status
      - events
      - payment
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
          - confirmed
          - shipped
          - tracking_updated
          - eta_updated
          - delivered
          - accepted
          - released
          - disputed
          - cancelled
        tracking:
          type:
          - object
          - 'null'
        supplier:
          type: object
          properties:
            supplierId:
              type:
              - string
              - 'null'
            supplierName:
              type:
              - string
              - 'null'
            supplierSlug:
              type:
              - string
              - 'null'
        supplierIds:
          type: array
          items:
            type: string
        agent:
          type:
          - object
          - 'null'
        items:
          type: array
          items:
            type: object
        testMode:
          type: boolean
        eta:
          type:
          - string
          - 'null'
          format: date-time
        events:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
              occurredAt:
                type: string
                format: date-time
        payment:
          type: object
          properties:
            status:
              type: string
            gross:
              type: number
            platformFee:
              type: number
            sellerNet:
              type: number
            currency:
              type: string
    CreateOrderRequest:
      type: object
      required:
      - quoteId
      - buyer
      - shippingAddress
      properties:
        quoteId:
          type: string
        buyer:
          type: object
          required:
          - name
          - email
          properties:
            name:
              type: string
            email:
              type: string
              format: email
        shippingAddress:
          type: object
        agent:
          type: object
          description: Agent identity retained for supplier communication
          properties:
            id:
              type: string
            name:
              type: string
            version:
              type: string
            callbackUrl:
              type: string
              format: uri
        payment:
          type: object
          properties:
            method:
              type: string
              enum:
              - usdc_escrow
              - fiat_manual
            chain:
              type: string
    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:
    Conflict:
      description: Idempotency or inventory conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    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'
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: true
      schema:
        type: string
        minLength: 8
        maxLength: 128
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    adminReviewKey:
      type: apiKey
      in: header
      name: X-Admin-Key