GET orders/{reference}¶

Retrieve a single order by its Dropday reference.

Endpoint¶

GET https://dropday.io/api/v1/orders/{reference}

Path parameters¶

Parameter	Type	Description
reference	String	The unique reference of the order (e.g., `123`).

See Orders for the response field reference. Order lines include logs on this endpoint.

Request¶

curl -X GET "https://dropday.io/api/v1/orders/123" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "api-key: tdh7nNUp3DZAHsMtw3dQYhDsm3wf593hMGbyXP6Y5R8DTF2Rwy4QCvkWFYQb" \
  -H "account-id: 101"

Response¶

200401404500

{
    "id": 1542,
    "external_id": "ORD-2025-00142",
    "reference": "123",
    "source": "Example Shop",
    "test": false,
    "blocked": false,
    "total": 156.45,
    "shipping_address": {
        "email": "[email protected]",
        "first_name": "Jane",
        "last_name": "Smith",
        "company_name": null,
        "phone": "+1 555 123 4567",
        "address1": "123 Main Street",
        "address2": "Apt 4B",
        "city": "New York",
        "postcode": "10001",
        "state": "NY",
        "country": "US"
    },
    "shipping": {
        "cost": 5.95,
        "name": "DHL Express",
        "description": "Next day delivery",
        "note": "Leave at front door",
        "delivery_date": "2025-09-25"
    },
    "custom": {
        "gift_wrap": true,
        "gift_message": "Happy Birthday!"
    },
    "order_lines": [
        {
            "id": 3201,
            "external_id": "PROD-001",
            "name": "Wireless Headphones",
            "ean13": "8712345678901",
            "reference": "WH-PRO-BLK",
            "quantity": 1,
            "stock_quantity": 150,
            "price": 89.99,
            "purchase_price": 45.00,
            "height": 8.5,
            "width": 18,
            "length": 20,
            "weight": 0.25,
            "brand": "AudioTech",
            "category": "Electronics",
            "image_url": "https://example.org/images/headphones.jpg",
            "custom": {
                "color": "Black",
                "warranty": "2 years"
            },
            "labels": ["fragile", "gift"],
            "current_status": "completed",
            "supplier": "AudioTech Wholesale",
            "matched_supplier": {
                "id": 5,
                "name": "TechSupply Co."
            },
            "logs": [
                {
                    "id": 12345601,
                    "status": "pending",
                    "message": "Order line created",
                    "created_at": "2025-09-22T14:30:00.000000Z"
                },
                {
                    "id": 12345602,
                    "status": "ruled",
                    "message": "Matched to supplier TechSupply Co.",
                    "created_at": "2025-09-22T14:30:05.000000Z"
                },
                {
                    "id": 12345603,
                    "status": "completed",
                    "message": "Successfully sent to supplier",
                    "created_at": "2025-09-22T14:31:12.000000Z"
                }
            ]
        },
        {
            "id": 3202,
            "external_id": "PROD-002",
            "name": "Phone Case",
            "ean13": "8712345678902",
            "reference": "PC-IP15-CLR",
            "quantity": 2,
            "stock_quantity": 500,
            "price": 29.99,
            "purchase_price": 12.50,
            "height": 1.2,
            "width": 8,
            "length": 16,
            "weight": 0.04,
            "brand": "CaseMaster",
            "category": "Accessories",
            "image_url": "https://example.org/images/phonecase.jpg",
            "custom": null,
            "labels": [],
            "current_status": "completed",
            "supplier": "CaseMaster Direct",
            "matched_supplier": {
                "id": 12,
                "name": "AccessoryWorld"
            },
            "logs": [
                {
                    "id": 12345601,
                    "status": "pending",
                    "message": "Order line created",
                    "created_at": "2025-09-22T14:30:00.000000Z"
                },
                {
                    "id": 12345602,
                    "status": "ruled",
                    "message": "Matched to supplier AccessoryWorld",
                    "created_at": "2025-09-22T14:30:05.000000Z"
                },
                {
                    "id": 12345603,
                    "status": "completed",
                    "message": "Successfully sent to supplier",
                    "created_at": "2025-09-22T14:32:45.000000Z"
                }
            ]
        }
    ],
    "suppliers": [
        {
            "id": 5,
            "name": "TechSupply Co."
        },
        {
            "id": 12,
            "name": "AccessoryWorld"
        }
    ],
    "created_at": "2025-09-22T14:30:00.000000Z",
    "updated_at": "2025-09-23T09:15:22.000000Z",
    "completed_at": "2025-09-23T09:15:22.000000Z"
}

{
    "message": "Unauthorized",
    "error": "Invalid or missing api-key or account-id header"
}

{
    "message": "Not Found",
    "error": "Order with reference 'INVALID-REF' not found"
}

{
    "message": "Internal Server Error",
    "error": "An unexpected error occurred. Please try again later."
}