Skip to main content
POST
/
delivery-requests
Create Delivery Request
curl --request POST \
  --url https://api.usedroptrail.com/delivery-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_location": "<string>",
  "to_location": "<string>",
  "receiver_phone": "<string>",
  "estimated_weight": 123,
  "package_count": 123,
  "description": "<string>",
  "delivery_deadline": "<string>",
  "is_interstate": true
}
'
{
  "id": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "sender_id": "<string>",
  "estimated_price": 123
}
Create a new delivery request in the system. The request will be visible to delivery partners who can then place bids.

​
Request Body

​
from_location
string
required
Full pickup location address including street, city, state and postal code
​
to_location
string
required
Full delivery destination address including street, city, state and postal code
​
receiver_phone
string
required
Phone number of the recipient in E.164 format (e.g. +1234567890)
​
estimated_weight
number
required
Estimated weight of the package in kilograms (max 500kg)
​
package_count
integer
required
Number of packages in the delivery (max 50)
​
description
string
Detailed description of the package contents and any special handling instructions
​
delivery_deadline
string
ISO 8601 formatted deadline for delivery completion (must be in the future)
​
is_interstate
boolean
Whether the delivery crosses state lines. Additional fees may apply.

​
Response

​
id
string
The unique identifier for the delivery request
​
status
string
Current status of the delivery request. Initially set to “PENDING”
​
created_at
string
ISO 8601 timestamp when the request was created
​
sender_id
string
ID of the user who created the request
​
estimated_price
number
Estimated delivery price in USD based on distance and weight

​
Example Request

{
  "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
}