> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List RFQs

> Get all RFQs for your business.

# List RFQs

Retrieves a paginated list of RFQs for the authenticated business.

## Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Number of items per page. Maximum 100.
</ParamField>

<ParamField query="status" type="string">
  Filter by RFQ status. One of: `pending`, `quoted`, `accepted`, `rejected`, `expired`.
</ParamField>

## Response

<ResponseField name="status" type="string">
  `success` on successful retrieval.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Data fields">
    <ResponseField name="total" type="integer">
      Total number of RFQs matching the filter.
    </ResponseField>

    <ResponseField name="page" type="integer">
      Current page number.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Items per page.
    </ResponseField>

    <ResponseField name="data" type="array">
      Array of RFQ objects.

      <Expandable title="RFQ fields">
        <ResponseField name="id" type="integer">
          RFQ ID.
        </ResponseField>

        <ResponseField name="order_number" type="string">
          Human-readable reference (e.g., `RFQ-2024-0001`).
        </ResponseField>

        <ResponseField name="status" type="string">
          Current status.
        </ResponseField>

        <ResponseField name="items" type="array">
          Line items in the RFQ.
        </ResponseField>

        <ResponseField name="customer" type="object">
          Customer information.
        </ResponseField>

        <ResponseField name="quotes_count" type="integer">
          Number of quotes created for this RFQ.
        </ResponseField>

        <ResponseField name="created_at" type="string">
          ISO 8601 timestamp.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Get all RFQs theme={null}
  curl https://api.khaime.com/api/v1/partner/rfq \
    -H "X-API-Key: pk_sandbox_your_key"
  ```

  ```bash Filter by status theme={null}
  curl "https://api.khaime.com/api/v1/partner/rfq?status=pending&page=1&limit=20" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "data": {
      "total": 25,
      "page": 1,
      "limit": 10,
      "data": [
        {
          "id": 789,
          "order_number": "RFQ-2024-0001",
          "status": "pending",
          "items": [
            { "product_id": 123, "quantity": 100 }
          ],
          "customer": {
            "id": 456,
            "name": "John Smith",
            "email": "john@acme.com"
          },
          "quotes_count": 0,
          "created_at": "2024-01-15T10:30:00Z"
        }
      ]
    }
  }
  ```
</ResponseExample>