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

# List Delivery Requests

> Retrieve a list of delivery requests

Get a paginated list of delivery requests associated with your account.

## Query Parameters

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

<ParamField query="limit" type="integer">
  Number of records per page (default: 20, max: 100)
</ParamField>

<ParamField query="status" type="string">
  Filter by delivery status (PENDING, ACCEPTED, IN\_TRANSIT, DELIVERED, CANCELLED)
</ParamField>

<ParamField query="from_date" type="string" format="date">
  Filter requests created on or after this date (ISO 8601)
</ParamField>

<ParamField query="to_date" type="string" format="date">
  Filter requests created before this date (ISO 8601)
</ParamField>

## Response

<ResponseField name="data" type="array">
  List of delivery request objects

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      The unique identifier for the delivery request
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the delivery request
    </ResponseField>

    <ResponseField name="from_location" type="string">
      Full pickup location address
    </ResponseField>

    <ResponseField name="to_location" type="string">
      Full delivery destination address
    </ResponseField>

    <ResponseField name="estimated_weight" type="number">
      Estimated weight of the package in kilograms
    </ResponseField>

    <ResponseField name="package_count" type="integer">
      Number of packages in the delivery
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the request was created
    </ResponseField>

    <ResponseField name="estimated_price" type="number">
      Estimated delivery price in USD
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination information

  <Expandable title="properties">
    <ResponseField name="total" type="integer">
      Total number of records
    </ResponseField>

    <ResponseField name="pages" type="integer">
      Total number of pages
    </ResponseField>

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

    <ResponseField name="per_page" type="integer">
      Number of records per page
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Response