Retrieve Pickup Details — GET /pickups/{pickupNumber}

Use this endpoint to retrieve the complete details of a single pickup by its pickupNumber. The response includes the full pickup object along with the selectedPickupAddress block, giving you the exact address the courier will visit. You receive the pickupNumber in the response of POST /pickups.

Authentication

All requests require a valid API key. Company account keys must also include the X-Merchant-Id header.

Authorization: Bearer nsk_live_YOUR_KEY
X-Merchant-Id: shop_123

X-Merchant-Id accepts your businessAccountCode (8-digit), externalMerchantId, or MongoDB _id. Single-business keys do not require this header.

Path parameter

string

required

The 6-digit pickup number returned when the pickup was created (e.g. 482917).

Example request

curl "https://now.com.eg/api/public/v1/pickups/482917" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "X-Merchant-Id: shop_123"

Response

A successful request returns HTTP 200 with the full pickup object and the linked address details.

boolean

true on success.

object

Show pickup fields

string

MongoDB _id of the pickup record.

string

6-digit pickup number.

string

Scheduled pickup date in YYYY-MM-DD format.

string

Current pickup status string (e.g. new, pendingPickup). Note: the field name is picikupStatus as returned by the API.

string

Status category for grouping.

string

Human-readable status label.

number

Expected order count for this pickup.

number

Server-computed pickup fee in EGP.

string

Courier contact phone number.

string

Pickup location text displayed to the courier.

string

The linked merchant pickup address ID.

boolean

Whether fragile items were flagged on this pickup.

boolean

Whether large or oversized items were flagged.

string

Notes attached for the courier.

string

ISO 8601 creation timestamp.

string

ISO 8601 timestamp of the most recent update.

object

Show selectedPickupAddress fields

string

Governorate of the pickup address (e.g. Cairo).

string

Exact zone value from the delivery zone catalog.

string

Street, building, and floor details.

string

Phone number associated with the pickup address.

string

Optional landmark to help the courier locate the address.

{
  "success": true,
  "data": {
    "pickup": {
      "pickupId": "66f1a2b3c4d5e6f7a8b9c0d3",
      "pickupNumber": "482917",
      "pickupDate": "2026-07-28",
      "picikupStatus": "new",
      "statusCategory": "new",
      "statusLabel": "New",
      "numberOfOrders": 15,
      "pickupFees": 50,
      "phoneNumber": "01012345678",
      "pickupLocation": "12 Street, Building 4, Cairo",
      "pickupAddressId": "66f1a2b3c4d5e6f7a8b9c0d4",
      "isFragileItems": false,
      "isLargeItems": false,
      "pickupNotes": "Call before arrival",
      "createdAt": "2026-07-26T12:00:00.000Z",
      "updatedAt": "2026-07-26T12:00:00.000Z",
      "selectedPickupAddress": {
        "city": "Cairo",
        "zone": "Nasr City - ElHay 06 (Nasr City)",
        "addressDetails": "12 Street, Building 4",
        "pickupPhone": "01000000000",
        "nearbyLandmark": "Near City Center"
      }
    }
  }
}

Error responses

HTTP status	Error code	Description
`404`	`NOT_FOUND`	No pickup exists with this `pickupNumber` under your account.
`401`	`UNAUTHORIZED`	Missing or invalid API key.
`403`	`MERCHANT_REQUIRED`	Company key used without `X-Merchant-Id`.
`403`	`MERCHANT_NOT_FOUND`	The merchant specified in `X-Merchant-Id` is not linked to your company.

System

Merchants

Fees

Orders

Pickups

Reference

Retrieve Pickup Details — GET /pickups/{pickupNumber}

Authentication

Path parameter

Example request

Response

Error responses

​Authentication

​Path parameter

​Example request

​Response

​Error responses

Authentication

Path parameter

Example request

Response

Error responses