curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "items": [
      { "product_id": 123, "quantity": 100 }
    ]
  }'

curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "customer_name": "John Smith",
    "customer_phone": "+1-555-123-4567",
    "company_name": "Acme Corporation",
    "cart_item_identifier": "cart_abc123",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "shipping_address": {
      "address": "123 Business Park",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postal_code": "10001"
    },
    "notes": "Need delivery within 2 weeks",
    "requested_delivery_date": "2024-02-15"
  }'

{
  "status": "success",
  "message": "RFQ submitted successfully",
  "data": {
    "rfq_id": 789,
    "order_number": "RFQ-2024-0001",
    "status": "pending",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "customer": {
      "id": 456,
      "name": "John Smith",
      "email": "john@acme.com"
    }
  }
}

POST

rfq

{product_id}

curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "items": [
      { "product_id": 123, "quantity": 100 }
    ]
  }'

curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "customer_name": "John Smith",
    "customer_phone": "+1-555-123-4567",
    "company_name": "Acme Corporation",
    "cart_item_identifier": "cart_abc123",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "shipping_address": {
      "address": "123 Business Park",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postal_code": "10001"
    },
    "notes": "Need delivery within 2 weeks",
    "requested_delivery_date": "2024-02-15"
  }'

{
  "status": "success",
  "message": "RFQ submitted successfully",
  "data": {
    "rfq_id": 789,
    "order_number": "RFQ-2024-0001",
    "status": "pending",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "customer": {
      "id": 456,
      "name": "John Smith",
      "email": "john@acme.com"
    }
  }
}

Submit RFQ

Submit an RFQ (Request for Quote) on behalf of a customer. The product_id in the URL identifies the business (similar to the payment-intent pattern). Only email is required - customer details can be collected later.

This endpoint enables B2B quote-based commerce flows where customers request quotes for bulk orders or custom pricing before purchasing. The product_id identifies which merchant will receive the RFQ.

Path Parameters

integer

required

Any product ID from the merchant’s catalog. Used to identify which business receives the RFQ.

Request Body

string

required

Customer’s email address. This is the only required field - used for quote notifications and account creation.

string

Cart identifier linking RFQ to customer’s cart. Useful for tracking cart-to-RFQ conversion.

array

required

List of products to request quotes for.

Show Item fields

integer

required

ID of the product in your Khaime catalog.

integer

required

Quantity requested. Must be at least 1.

integer

Price at time of cart addition (in cents). Useful for tracking price changes.

object

Product variation details if applicable.

Show Variation fields

string

Product variation ID.

string

Variation ID.

string

Sub-variation ID.

string

Notes specific to this line item (e.g., “Need in blue color”).

string

Full name of the customer. Optional - can be collected later.

string

Customer’s phone number. Optional - can be collected later.

string

Customer’s company name. Optional - can be collected later.

object

Shipping address for the order. Optional - can be collected when sending quote.

Show Address fields

string

Street address.

string

City.

string

State or province.

string

Country.

string

Postal or ZIP code.

string

General notes for the entire RFQ (e.g., “Need delivery within 2 weeks”).

string

Requested delivery date in ISO 8601 format (e.g., 2024-02-15).

Response

string

success on successful submission.

string

Human-readable message.

object

Show Data fields

integer

The ID of the created RFQ (order).

string

Human-readable RFQ reference (e.g., RFQ-2024-0001).

string

Initial status is pending.

array

The line items in the RFQ.

object

Customer information including id, name, and email.

Error Codes

Status	Error	Fix
`400`	Validation error	Check required fields and data types
`401`	Invalid API key	Verify your `X-API-Key` header
`404`	Product not found	Check that `product_id` exists in your catalog

curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "items": [
      { "product_id": 123, "quantity": 100 }
    ]
  }'

curl -X POST https://api.khaime.com/api/v1/partner/rfq/123 \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "john@acme.com",
    "customer_name": "John Smith",
    "customer_phone": "+1-555-123-4567",
    "company_name": "Acme Corporation",
    "cart_item_identifier": "cart_abc123",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "shipping_address": {
      "address": "123 Business Park",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postal_code": "10001"
    },
    "notes": "Need delivery within 2 weeks",
    "requested_delivery_date": "2024-02-15"
  }'

{
  "status": "success",
  "message": "RFQ submitted successfully",
  "data": {
    "rfq_id": 789,
    "order_number": "RFQ-2024-0001",
    "status": "pending",
    "items": [
      {
        "product_id": 123,
        "quantity": 100,
        "notes": "Need in blue color"
      },
      {
        "product_id": 456,
        "quantity": 50
      }
    ],
    "customer": {
      "id": 456,
      "name": "John Smith",
      "email": "john@acme.com"
    }
  }
}

API Reference

Account

Products & Pricing

Payments

Subscriptions

Marketplace

Submit RFQ

Submit RFQ

Path Parameters

Request Body

Response

Error Codes

​Submit RFQ

​Path Parameters

​Request Body

​Response

​Error Codes

Submit RFQ

Path Parameters

Request Body

Response

Error Codes