Endpoint

GET https://api.gospeedlog.com/deliveries/{order_number}

Path Parameters

order_number string required
The order number (e.g. ORD-0012345)

Required Headers

x-gsl-token string required
Your API authentication token
x-gsl-secret string required
Your API secret key
Content-Type string required
Must be set to application/json

Request Example (cURL)

curl --request GET \
--url https://api.gospeedlog.com/deliveries/ORD-0012345 \
--header 'x-gsl-token: ' \
--header 'x-gsl-secret: ' \
--header 'Content-Type: application/json'

Replace <your_api_token> and <your_api_secret> with your actual credentials.

Response

200 OK
The request was successful. Returns complete delivery details in JSON format.
Response Body
{
"order_number": "ORD-12345",
"pickup": {
"customer_name": "John Doe",
"address": "123 Main St, New York, NY 10001",
"phone_number": "+11234567890"
},
"dropoff": {
"customer_name": "Jane Smith",
"address": "456 Oak Ave, Brooklyn, NY 11201",
"phone_number": "+10987654321"
},
"package": {
"type": "box",
"content": "Electronics",
"size": "medium",
"height": 10,
"width": 15,
"length": 20,
"weight": 2.5
},
"estimated_delivery_time": 120,
"estimated_distance": 15.5,
"pickup_date": "2024-01-15",
"pickup_time": "09:00:00",
"delivery_date": "2024-01-15",
"delivery_time": "14:00:00",
"status": "pending",
"created_at": "2024-01-15T08:00:00Z"
}
400 Bad Request
The delivery order number provided was invalid.
401 Unauthorized
Your API key is missing or invalid. Make sure authentication headers are included in the request.
404 Not Found
The specified delivery order number was not found.
Response Body
{
  "error": "Not Found",
  "message": "Delivery with order number ORD-0012345 not found"
}

Common Error Codes

  • 400 Bad Request: Invalid request data or missing required fields
  • 401 Unauthorized: Invalid or missing API credentials (x-gsl-token or x-gsl-secret)
  • 404 Not Found: Delivery not found
  • 422 Unprocessable Entity: Cannot process request (e.g., trying to cancel a completed delivery)
  • 500 Internal Server Error: Server error

Validation Errors

When validation fails, the API returns a 400 status code with detailed error information:

{
  "error": "Not Found",
  "message": "Delivery with order number ORD-0012345 not found"
}

Support

For API support and questions, please contact our development team at api-support@gospeedlog.com .

Our team typically responds within 24 hours during business days.