> ## 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.

# Create Delivery Request

> Create a new delivery request

Create a new delivery request in the system. The request will be visible to delivery partners who can then place bids.

## Request Body

<ParamField body="from_location" type="string" required>
  Full pickup location address including street, city, state and postal code
</ParamField>

<ParamField body="to_location" type="string" required>
  Full delivery destination address including street, city, state and postal code
</ParamField>

<ParamField body="receiver_phone" type="string" required>
  Phone number of the recipient in E.164 format (e.g. +1234567890)
</ParamField>

<ParamField body="estimated_weight" type="number" required>
  Estimated weight of the package in kilograms (max 500kg)
</ParamField>

<ParamField body="package_count" type="integer" required>
  Number of packages in the delivery (max 50)
</ParamField>

<ParamField body="description" type="string">
  Detailed description of the package contents and any special handling instructions
</ParamField>

<ParamField body="delivery_deadline" type="string" format="date-time">
  ISO 8601 formatted deadline for delivery completion (must be in the future)
</ParamField>

<ParamField body="is_interstate" type="boolean">
  Whether the delivery crosses state lines. Additional fees may apply.
</ParamField>

## Response

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

<ResponseField name="status" type="string">
  Current status of the delivery request. Initially set to "PENDING"
</ResponseField>

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

<ResponseField name="sender_id" type="string">
  ID of the user who created the request
</ResponseField>

<ResponseField name="estimated_price" type="number">
  Estimated delivery price in USD based on distance and weight
</ResponseField>

## Example Request

```json theme={null}
{
  "from_location": "123 Main St, Anytown, USA, 12345",
  "to_location": "456 Elm St, Anytown, USA, 12345",
  "receiver_phone": "+1234567890",
  "estimated_weight": 10,
  "package_count": 2,
  "description": "Fragile items, please handle with care",
  "delivery_deadline": "2025-01-31T12:00:00Z",
  "is_interstate": false
}
```