---
title: "Submit a structured, non-binding supplier inquiry"
method: POST
path: "/v1/inquiries"
---

# Submit a structured, non-binding supplier inquiry

`POST /v1/inquiries`

## Request

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

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.

## Headers

- `Idempotency-Key` string

## Request body

- InquiryRequest
  - `items` object[], required
    - `sku` string, required
    - `quantity` integer, required
    - `note` string
  - `destination` object, required
    - `country` string, required
    - `city` string
    - `region` string
    - `postalCode` string
  - `buyer` object, required
    - `email` string, email, required
    - `company` string
    - `name` string
  - `agent` object
    - `id` string
    - `name` string
    - `version` string
  - `message` string
  - `idempotencyKey` string

## Response `202`

Inquiry stored and supplier notification attempted

- InquiryEnvelope
  - `status` 'ok', required
  - `data` object, required
    - `inquiryId` string, required
    - `status` 'submitted', required
    - `items` object[], required
    - `destination` object
    - `buyer` object
    - `agent` object, nullable
    - `notifications` object[], required
    - `notificationStatus` 'delivered' | 'partial' | 'failed'
    - `nextStep` string
  - `error` unknown, required

## Other responses

- `404`: Resource not found
- `422`: Validation failed

---

[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)