quipteams

POST/quotes

scopequotes:writereturns202rate limit20 / min

Create a quote

Creates a quote and starts fulfillment asynchronously (returns 202 with the full quote detail). Each item references EITHER a catalog `product_id` OR a `kit_id` - exactly one. Per item, the sum of recipient quantities must equal the item quantity.

Body

requester_emailrequired

stringEmail of the person requesting the quote.

requester_name

stringRequester display name.

po_number

stringPurchase order reference.

notification_emails

string[]Extra addresses to notify about this quote.

itemsrequired

object[]1-50 items. Each has product_id OR kit_id, quantity, comments, and recipients[].

items[].recipientsrequired

object[]name, country, address are required — unless office_id is set; email is also required unless the recipient is an office or storage. phone_number, hire_date, when_to_contact (YYYY-MM-DD), storage, quantity are optional.

items[].recipients[].office_id

stringShip to a saved office (id from GET /api/v1/offices) — the office supplies the country and address, so sending either alongside it (or storage) is rejected. name, email and phone_number may still be supplied to name a person at that office.

Example request

json

{
  "requester_email": "jane@acme.com",
  "requester_name": "Jane Smith",
  "po_number": "PO-9981",
  "notification_emails": ["it@acme.com"],
  "items": [
    {
      "product_id": "6f9d0e2a-1b3c-4d5e-8f70-2a1b3c4d5e6f",
      "quantity": 2,
      "comments": "Ship together if possible",
      "recipients": [
        {
          "name": "Alex Doe",
          "email": "alex@acme.com",
          "country": "United States",
          "address": "123 Market St, San Francisco, CA 94103",
          "phone_number": "+1 415 555 0100",
          "when_to_contact": "2026-03-01",
          "quantity": 1
        },
        {
          "office_id": "3f2b9c4e-6a1d-4f8b-9c2e-7d5a1b3c9e4f",
          "quantity": 1
        }
      ]
    }
  ]
}

Example response

json

{
  "data": {
    "order_id": "1741345200000",
    "status": "in_progress",
    "status_timestamps": { "in_progress": "2026-02-15T10:30:00.000Z" },
    "countries": ["United States"],
    "requester": { "email": "jane@acme.com", "name": "Jane Smith" },
    "items": [
      {
        "id": "8a2b1c3d-4e5f-6071-8293-a4b5c6d7e8f9",
        "product_type": "Laptop",
        "quantity": 2,
        "status": "pending",
        "price": null,
        "specification": {
          "brand": "Apple", "model": "MacBook Pro 14", "os": "macOS",
          "cpu": "M5 Pro", "ram": "18GB", "storage": "512GB",
          "screen_size": "14", "keyboard_layout": "US"
        },
        "comments": "Ship together if possible",
        "recipients": [
          {
            "id": "b1c2d3e4-f506-4718-92a3-b4c5d6e7f809",
            "name": "Alex Doe",
            "email": "alex@acme.com",
            "country": "United States",
            "status": "pending",
            "status_timestamps": {},
            "phone_number": "+1 415 555 0100",
            "address": "123 Market St, San Francisco, CA 94103",
            "storage": false,
            "serial_number": null,
            "tracking_code": null,
            "tracking_link": null,
            "invoice_number": null,
            "hire_date": null,
            "schedule_link": null,
            "is_office": false,
            "office_id": null
          }
        ],
        "alternatives": [],
        "created_at": "2026-02-15T10:30:00.000Z"
      }
    ],
    "created_at": "2026-02-15T10:30:00.000Z",
    "updated_at": "2026-02-15T10:30:00.000Z",
    "po_number": "PO-9981"
  }
}