---
title: "A request for quote to merchants from a bill of materials, with no price"
method: POST
path: "/supplier-quote-request"
tags: ["Quotes"]
---

# A request for quote to merchants from a bill of materials, with no price

`POST /supplier-quote-request`

## Request

- Base URL: `https://api.craftquantities.com/v1`
- URL: `https://api.craftquantities.com/v1/supplier-quote-request`
- Auth: none declared

## Query parameters

- `detail` 'full' | 'summary': full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
- `format` 'json' | 'md'

## Request body

- object
  - `items` object[], required
    - `description` string
    - `label` string
    - `name` string
    - `quantity` number
    - `unit` string
    - `order` object
      - `quantity` number
      - `unit` string
    - `notes` string
    - `packSize` number
    - `packs` number
    - `packName` string
  - `project` string: The project's name, as the merchants will see it.
  - `currency` string: The currency prices are asked in; left out, the market's.
  - `market` 'US' | 'CA' | 'UK' | 'AU' | 'INTL': Optional. A market whose own opening choice some inputs take (a UK reader's code, an IEC motor), and whose currency symbol prints the caller's own money figures.
  - `note` string: A note to the merchants: delivery address area, dates, access.

## Response `200`

The request as Markdown, CSV, the site's link and a My Project file.

- union
  - object
    - `engine` object, required
    - `project` string, required
    - `currency` string, required
    - `rows` object[], required
      - `label` string, required
      - `quantity` number, required
      - `unit` string, required
      - `packSize` number
      - `packs` number
      - `packName` string
    - `dropped` integer
    - `markdown` string, required: The request, to paste into a message.
    - `csv` object, required
    - `link` string, required: The site's request link: the merchant opens it, prices it in their own browser and sends a reply link back.
    - `howToSend` string, required
    - `requestFile` object, required
      - `schema` string: The open JSON Schema the request file follows, for a supplier's own software.
    - `file` object, required
    - `howToImport` string, required
    - `links` object, required
    - `licence` object, required
      - `name` string, required
      - `url` string, required
      - `attribution` string, required
    - `notice` string, required
  - object
    - `detail` 'summary', required
    - `tool` string, required
    - `title` string, required
    - `lines` object[], required: The result lines, as the report's table gives them.
    - `notes` string[], required: What a professional must decide, when to call one, a false-friend warning, that adoption is local: kept in every summary.
    - `citation` string, required: The one citation line, built from the answer's own data.
    - `url` string, nullable, required
    - `open` string, nullable, required
    - `more` string, nullable, required

## Other responses

- `400`: The request was refused; every problem is listed.
- `413`: The request was refused; every problem is listed.

---

[API](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api.md) · [All operations](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api/revisions/a69883abc23b?raw)