# Now Com

## Docs

- [Now Shipping Public API v1 — Changelog and Version History](https://docs.nowshipping.co/APIdoc/api/changelog.md): Release notes for the Now Shipping Public API v1. Version 1.0 (July 2026) introduces multi-tenant support, CRUD for orders and pickups, and AWB PDF.
- [GET /delivery-zones — Zone Catalog with ETag Caching](https://docs.nowshipping.co/APIdoc/api/delivery-zones.md): Retrieve the authoritative catalog of governorates and delivery zones. Use exact area values in all order and merchant onboarding requests.
- [API Endpoint Summary — All Now Shipping Public API v1 Routes](https://docs.nowshipping.co/APIdoc/api/endpoint-summary.md): Reference table of all 20 Now Shipping Public API v1 endpoints — method, path, required scope, and X-Merchant-Id rules for company integrators.
- [Error Reference: Codes, Status Codes, and Troubleshooting](https://docs.nowshipping.co/APIdoc/api/errors.md): Full error reference for the Now Shipping Public API v1: HTTP status codes, machine-readable error codes, validation messages, and troubleshooting steps.
- [POST /fees/calculate — Preview Shipping Fee for an Order](https://docs.nowshipping.co/APIdoc/api/fees/calculate.md): Calculate the shipping fee for a given governorate and order type. Preview the EGP cost before creating an order — never send this value in requests.
- [POST /merchants — Onboard a New Merchant Sub-Account](https://docs.nowshipping.co/APIdoc/api/merchants/create.md): Create a ready-to-ship Now Shipping merchant sub-account in one API call. Returns businessAccountCode for immediate use as X-Merchant-Id.
- [GET /merchants/{merchantId} — Retrieve a Merchant by ID](https://docs.nowshipping.co/APIdoc/api/merchants/get.md): Fetch a single merchant sub-account linked to your company by businessAccountCode, externalMerchantId, or MongoDB _id. Requires the merchants scope.
- [GET /merchants — Paginated Merchant Sub-Account List](https://docs.nowshipping.co/APIdoc/api/merchants/list.md): List all merchant sub-accounts linked to your company account. Supports pagination and full-text search by name, email, phone, brandName, and IDs.
- [GET /orders/{orderNumber}/awb — Download Order AWB PDF](https://docs.nowshipping.co/APIdoc/api/orders/awb.md): Download the Air Waybill shipping label PDF for a given order. Supports A4 and A5 paper sizes. Response body is application/pdf binary content.
- [POST /orders/{orderId}/cancel — Cancel an Order by ID](https://docs.nowshipping.co/APIdoc/api/orders/cancel.md): Cancel an order by order ID or number. Cancellation eligibility depends on current order status. Returns error with currentStatus if not cancellable.
- [POST /orders — Create a Deliver, Return, or Exchange](https://docs.nowshipping.co/APIdoc/api/orders/create.md): Create a Deliver, Return, or Exchange shipping order. Provide zone values from the /delivery-zones catalog. Fees are always computed server-side.
- [DELETE /orders/{orderId} — Delete an Order by ID](https://docs.nowshipping.co/APIdoc/api/orders/delete.md): Permanently delete a new-status order. Orders that have progressed past new status must go through the cancel endpoint instead of delete.
- [GET /orders/{orderNumber} — Get Full Order Details](https://docs.nowshipping.co/APIdoc/api/orders/get.md): Retrieve complete details for a single order by its 6-digit order number, including status labels, tracking stages, and pickup address.
- [GET /orders — List Orders with Filters and Pagination](https://docs.nowshipping.co/APIdoc/api/orders/list.md): List orders for your account or merchant. Filter by type, status, payment, and date range. Supports pagination and full-text search.
- [PUT /orders/{orderId} — Update an Existing Order](https://docs.nowshipping.co/APIdoc/api/orders/update.md): Update order details while the order is in an editable status. Fees are recomputed automatically. Zone and express restrictions apply.
- [Calculate Pickup Fee — POST /pickups/calculate-fee](https://docs.nowshipping.co/APIdoc/api/pickups/calculate-fee.md): Preview the pickup fee before scheduling. Pass numberOfOrders for an accurate EGP estimate. Never send the returned fee in create or update requests.
- [Cancel a Pickup — POST /pickups/{pickupNumber}/cancel](https://docs.nowshipping.co/APIdoc/api/pickups/cancel.md): Cancel a scheduled pickup by pickup number. Cancellation depends on current status — the API returns currentStatus in error details when blocked.
- [Create and Schedule a Courier Pickup — POST /pickups](https://docs.nowshipping.co/APIdoc/api/pickups/create.md): Schedule a courier pickup for your merchant location. Provide a pickupDate, numberOfOrders, and phoneNumber — Now Shipping computes the fee automatically.
- [Hard-Delete a Pickup Record — DELETE /pickups/{pickupNumber}](https://docs.nowshipping.co/APIdoc/api/pickups/delete.md): Permanently delete a pickup in 'new' or 'pendingPickup' status. This hard-removes the record — use the cancel endpoint for pickups in any other state.
- [Retrieve Pickup Details — GET /pickups/{pickupNumber}](https://docs.nowshipping.co/APIdoc/api/pickups/get.md): Retrieve full pickup details by pickup number, including status, fees, and the linked pickup address the courier will visit on the scheduled date.
- [List Pickups: Paginated Endpoint with Status Filters](https://docs.nowshipping.co/APIdoc/api/pickups/list.md): List pickups for your account or merchant. Filter by status, date range, and pickup type (Upcoming or Completed). Default page size is 30 results.
- [Update a Scheduled Pickup — PUT /pickups/{pickupNumber}](https://docs.nowshipping.co/APIdoc/api/pickups/update.md): Update a pickup in 'new' or 'pendingPickup' status. Change any field you need — pickup fees are recomputed server-side on every successful update.
- [GET /ping — API Key Verification and Account Identity](https://docs.nowshipping.co/APIdoc/api/ping.md): Verify your API key is valid and active. Returns the account name, company status, enabled scopes, and key prefix. No scope required to call this endpoint.
- [Now Shipping API Authentication and API Keys Guide](https://docs.nowshipping.co/APIdoc/authentication.md): Every Now Shipping API request requires a valid API key. Pass it as a Bearer token or X-Api-Key header, and verify it using GET /ping.
- [Now Shipping API Key Scopes: orders, pickups, merchants](https://docs.nowshipping.co/APIdoc/concepts/api-key-scopes.md): Now Shipping API keys carry scopes that control which endpoint groups they can access. A missing scope returns 403 SCOPE_DENIED immediately.
- [Now Shipping API Glossary: Terms and Concepts Defined](https://docs.nowshipping.co/APIdoc/concepts/glossary.md): Definitions for key terms used throughout the Now Shipping API: businessAccountCode, AWB, zone catalog, company account, and more.
- [Multi-Tenant Integration Model for Company Accounts](https://docs.nowshipping.co/APIdoc/concepts/multi-tenant.md): Use one company API key to manage unlimited merchant sub-accounts. Route each request to the correct merchant using X-Merchant-Id.
- [Now Shipping API Rate Limits and Throttling (120/min)](https://docs.nowshipping.co/APIdoc/concepts/rate-limiting.md): Now Shipping API enforces 120 requests per minute per API key. Exceeding the limit returns HTTP 429. Use exponential backoff to recover.
- [Now Shipping API Response Format and JSON Envelope](https://docs.nowshipping.co/APIdoc/concepts/response-format.md): Every Now Shipping API response uses a consistent JSON envelope with success, data, and error fields. Pagination is included on list endpoints.
- [Now Shipping API: Best Practices and Go-Live Checklist](https://docs.nowshipping.co/APIdoc/guides/best-practices.md): Checklist and recommendations for a reliable Now Shipping API integration: zone caching, fee handling, merchant ID storage, and error logging.
- [End-to-End Integration: Onboard, Ship, and Schedule Pickup](https://docs.nowshipping.co/APIdoc/guides/end-to-end.md): Complete walkthrough for company integrators: onboard a merchant, create a delivery order, download the AWB, and schedule a courier pickup.
- [Now Shipping Public API: Logistics Integration for Egypt](https://docs.nowshipping.co/APIdoc/overview.md): Now Shipping Public API v1 lets you embed courier logistics into any e-commerce platform or SaaS product covering Cairo, Giza, and Qalyubia.
- [Now Shipping API Quickstart: Place Your First Shipment](https://docs.nowshipping.co/APIdoc/quickstart.md): Ship your first order through Now Shipping API: load zones, onboard a merchant, create an order, download the AWB, and schedule a pickup.