Skip to main content

Get Single Order

This guide explains how e-commerce partners can retrieve a single order by its unique identifier using the Nowpost API.

Endpoint​

GET /orders/{id}

Authentication​

  • You must be authenticated to view an order.
  • Generate your API token using the Partner API Token Generation endpoint.
  • Include your API token in the Authorization header as a Bearer token in every request.

Headers:

Authorization: Bearer <your_api_token_from_/partner/api-keys>
Content-Type: application/json

Path Parameter​

  • id (string, required): The unique identifier (UUID) of the order you want to retrieve.

Example Request​

GET /orders/123e4567-e89b-12d3-a456-426614174000
Authorization: Bearer <your_api_token>

Response​

200 OK

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "partnerId": "<partner_id>",
    "receiverEmail": "customer@example.com",
    "receiverFirstName": "Jane",
    "receiverLastName": "Doe",
    "items": [
      {
        "description": "Product Name",
        "weight": 2.5,
        "length": 10.0,
        "width": 5.0,
        "height": 3.0,
        "quantity": 2,
        "value": 1000
      }
    ],
    "deliveryFee": 500,
    "note": "Handle with care",
    "status": "delivered",
    "createdAt": "2025-08-12T12:00:00Z"
  }
}

Error Responses​

  • 400 Bad Request: Invalid order ID format.
  • 401 Unauthorized: Authentication failed or missing token.
  • 404 Not Found: Order not found.
  • 500 Internal Server Error: Server error.

For more details, see the API Reference.