- 🗂️ Overview
- 🚀 Quickstart
- Authentication
- Webhooks
- Errors
- Pagination
- Rate limits
- API terms
- Versioning
- Changelog
- Merchant APIs
- Identity
- Catalog
- Create new product
- List products
- Get product by ID
- Update product
- Delete product
- Upload product image
- Delete product image
- Set product image alt text
- Download CSV import template
- Import products from CSV
- Export products as CSV
- List variants for a product
- Create a variant
- Update a variant
- Delete a variant
- List gift cards
- Issue a new gift card
- Get gift card
- List gift card transactions
- Void a gift card (zero remaining balance)
- Get inventory list
- Get inventory statistics
- Adjust stock level
- Bulk adjust stock levels
- List all inventory levels for a store
- List inventory levels for a variant
- List inventory levels at a location
- Set inventory level at a location
- List inventory transfers
- Create a draft transfer
- Get transfer
- Replace lines (DRAFT only)
- Move transfer through its state machine
- Create new category
- List categories
- Get category by ID
- Update category
- Delete category
- Upload category image
- Create upsell rule
- List upsell rules
- Get upsell rule
- Update upsell rule
- Delete upsell rule
- Create product bundle
- List bundles for a store or product
- Set bundles for a product (replace all)
- Get bundle details
- Update bundle
- Delete bundle
- Reorder bundles
- Orders & fulfillment
- List payment proofs for an orderGET
- List manual-payment orders awaiting merchant reviewGET
- Create new orderPOST
- List ordersGET
- Create a draft orderPOST
- Convert draft order to a real orderPOST
- List COD Autopilot exception ordersGET
- Resolve (dismiss) a COD Autopilot exceptionPOST
- Per-status order counts (list tab badges)GET
- Update orderPATCH
- Cancel orderDELETE
- Update order statusPATCH
- Mark order as paidPOST
- Undo a manual mark-paid (payment back to pending)POST
- Customer kept part of the order at the doorPOST
- Get order timelineGET
- List order activity stream (staff comments + system events)GET
- Add a staff comment to an orderPOST
- Bulk update order statusesPOST
- Resend order status emailPOST
- Preview order status emailGET
- WhatsApp sends for an orderGET
- Resend the WhatsApp order confirmationPOST
- Abandoned vs recovered carts — counts, value, paybackGET
- List abandoned checkouts for a storeGET
- Get an abandoned checkoutGET
- Send a recovery email to the abandoned-checkout's customerPOST
- Manually mark an abandoned checkout as recoveredPOST
- Turn an abandoned checkout into a real COD orderPOST
- Send a WhatsApp abandoned-cart recovery nudgePOST
- Preview a CSV order import (parses headers + suggests mapping)POST
- Execute a CSV order import with a confirmed mappingPOST
- List the target fields the importer understandsGET
- Send the order's payment link into a linked conversationPOST
- Request a refund for an orderPOST
- List refunds for an orderGET
- Get refund detailsGET
- Approve a refund requestPOST
- Reject a refund requestPOST
- Process a refund through payment providerPOST
- List all refunds for a storeGET
- List returns for the storeGET
- Get one returnGET
- Approve a pending returnPOST
- Reject a returnPOST
- Mark a return as physically receivedPOST
- Issue refund for a received returnPOST
- Carrier catalog with this store's connection stateGET
- Save credentials for a carrierPUT
- Disconnect a carrierDELETE
- Verify a carrier's stored credentialsPOST
- Change a connected carrier's settingsPATCH
- Known Egyptian couriers to start fromGET
- This store's courier profilesGET
- Add a courierPOST
- Update a courierPATCH
- Remove a courierDELETE
- Print waybills for a batch of shipmentsPOST
- Print one waybillGET
- Export the pickup manifest as CSVGET
- Preview a courier's status sheetPOST
- Apply reviewed status rowsPOST
- Create shipmentPOST
- List shipmentsGET
- Bulk create shipmentsPOST
- Shipment dashboard statsGET
- COD reconciliation summaryGET
- List pickupsGET
- Schedule a pickupPOST
- Get shipment detailGET
- Update shipment on BostaPATCH
- Cancel shipmentPOST
- Request return shipmentPOST
- Track shipmentGET
- Print AWB (Air Waybill)GET
- Get delivery details from BostaGET
- Get business pickup locationsGET
- Get pickup detailsGET
- Update pickupPATCH
- Cancel pickupDELETE
- Get Bosta citiesGET
- Get zones in a cityGET
- Record an out-of-band payment against an orderPOST
- Get order by ID or order numberGET
- List payment proofs for an order
- Settings & money
- Stream a payment proof image (merchant-authenticated)
- Approve a customer-submitted proof
- Reject a customer-submitted proof
- Find perceptually similar prior proofs in this store
- Create new invoice
- List store invoices
- Get invoice details
- Update draft invoice
- Delete draft invoice
- Submit invoice to ETA
- Download invoice PDF
- Get (or create) the invoice for an order
- List locations
- Create location
- Get location
- Update location
- Delete location
- Get all store settings
- Get payment settings
- Update payment settings
- Get COD trust network protection settings
- Update COD trust network protection settings
- Get COD Autopilot settings
- Update COD Autopilot settings
- Get storefront password-protection status
- Enable/disable storefront password & set the password
- Get the store's custom product-label definitions
- Replace the store's custom product-label definitions
- Save Paymob credentials
- Get Paymob credentials status
- Remove Paymob credentials
- Save Kashier credentials
- Get Kashier credentials status
- Remove Kashier credentials
- Save Fawaterak credentials
- Get Fawaterak credentials status
- Remove Fawaterak credentials
- Save Moyasar credentials
- Get Moyasar credentials status
- Remove Moyasar credentials
- Get shipping settings
- Update shipping settings
- Add shipping zone
- Update shipping zone
- Delete shipping zone
- Save Bosta credentials
- Get Bosta credentials status
- Remove Bosta credentials
- Get invoice/tax settings
- Update invoice/tax settings
- Get WhatsApp settings
- Update WhatsApp settings
- Get storefront customization settings
- Update storefront customization (save draft)
- Publish storefront customization to live store
- Reset storefront customization to theme defaults
- Upload a customization asset (logo, favicon, hero image)
- List customization assets
- Update an asset's alt text / display name
- Delete a customization asset
- Get checkout fields config
- Update checkout fields config
- Save InstaPay credentials
- Get InstaPay credentials status
- Remove InstaPay credentials
- Save Vodafone Cash credentials
- Get Vodafone Cash credentials status
- Remove Vodafone Cash credentials
- Save WE Pay credentials
- Get WE Pay credentials status
- Remove WE Pay credentials
- Save Orange Cash credentials
- Get Orange Cash credentials status
- Remove Orange Cash credentials
- Upload merchant-generated InstaPay QR image
- Remove the uploaded InstaPay QR image
- Get all tracking settings
- Get the tracking-credential validation contract
- Save Meta Pixel + CAPI settings
- Disconnect Meta tracking
- Send a synthetic Purchase test event to Meta
- Get recent Meta CAPI events
- Verify the Meta Pixel against Meta
- Get Meta Event Match Quality
- Get Meta tracking status
- Save TikTok Pixel + Events API settings
- Disconnect TikTok tracking
- Send a synthetic Purchase test event to TikTok
- Get recent TikTok Events API events
- Get TikTok Events API deliveries that failed
- Re-send failed TikTok Events API deliveries
- Verify the TikTok Pixel against TikTok
- Get TikTok tracking status
- Get TikTok Marketing ad-performance report
- Connect TikTok Shop (persist token + shop)
- TikTok Shop connection status
- Disconnect TikTok Shop
- Get onboarding progress
- Complete an onboarding step
- Skip an onboarding step
- Dismiss onboarding
- Restore dismissed onboarding
- Auto-configure store from wizard answers
- List reconciliation runs
- Get mismatches for a reconciliation run
- Resolve or reopen a reconciliation mismatch
- Trigger reconciliation for a date
- Payment volume broken down by gateway
- List shipping zones
- Create a shipping zone
- Get a shipping zone
- Update a shipping zone
- Deactivate (soft-delete) a shipping zone
- Create a rate on a zone
- Update a rate
- Deactivate a rate
- Return covered/uncovered governorates for the store
- Apply the Quick Start: Egypt 4-zone preset
- Preview rates for a cart (merchant calculator tool)
- Get Balances
- List Transactions
- List Invoices
- List installable apps
- List installs for this store
- Install an app
- Update app settings
- Disable app
- Enable app
- Uninstall app
- Void a payment the merchant recorded by hand
- Print the invoice for an order, paid or not
- Signed link to a Partner App's own admin
- The store's subscription to a paid app
- Pay for a paid app from the store's wallet
- Cancel a paid app at the end of the paid period
- Re-send failed Meta Conversions API deliveries
- Analytics
- Get dashboard statistics
- Get revenue chart data
- Get top selling products (dashboard)
- Get daily order streak
- Get sales overview
- Get sales chart data
- Get top selling products (analytics)
- Get sales by location
- Get customer analytics
- Get conversion statistics
- Get orders by traffic source
- Get COD rejection statistics
- Get merchant health score
- Get orders breakdown analytics
- Get revenue breakdown analytics
- Get customer RFM segmentation
- Get inventory analytics (sell-through, ABC, dead stock)
- Get product performance analytics
- Get top storefront search terms
- Customer health scores + states
- Statistical predictions (stockouts, bands, repeat, COD)
- Get active advisor signals
- Dismiss an advisor signal
- Re-run the advisor rules for this store now
- Executive dashboard — what should I do today?
- Anonymous peer benchmarks (k-anonymity gated)
- Custom report: metrics grouped by a chosen dimension
- Get weekly-digest preferences
- Set weekly-digest preferences
- Preview the weekly analytics digest
- Get store-event annotations for charts
- Get metric targets with live pace
- Set metric targets
- Get conversion funnel
- Get marketing attribution analytics
- Get customer LTV by first-touch acquisition channel
- Get AI-powered store insights
- Get sales forecast
- Get customer sessions list
- Get session detail timeline
- Multi-touch attribution per channel + campaign
- Get real-time analytics snapshot
- Today's orders by location (governorate)
- SSE stream for real-time analytics
- Customers
- Preview a CSV customer import (parses headers + suggests mapping)
- Execute a CSV customer import with a confirmed mapping
- List the target fields the customer importer understands
- List store customers
- Create a customer manually
- Get customer by ID
- Get customer COD trust network stats
- Erase a customer's analytics footprint (DSAR)
- Get a customer's full touchpoint journey
- Conversations linked to this customer
- Adopt a linked conversation's profile picture as the customer photo
- Marketing
- Create new coupon
- List coupons
- Get coupon by ID
- Update coupon
- Delete coupon
- Bulk-update promotion priorities (drag-to-reorder)
- Issue a short-lived preview token for the builder iframe
- List promotions for a store
- Create a new promotion
- Get a single promotion by id
- Update a promotion (optimistic lock via `version`)
- Soft-delete (archive) a promotion
- Duplicate a promotion as a new draft
- Move a promotion to ACTIVE
- Move a promotion to PAUSED
- Move a promotion to ARCHIVED
- Aggregate analytics for one promotion within a date range
- List social connections
- Connect social account
- Disconnect social account
- Fetch posts from connected account
- Import social posts as draft products
- Import products from Instagram/Facebook post URLs
- Get Meta Embedded Signup config
- Complete WhatsApp embedded signup
- Disconnect WhatsApp Business
- Get WhatsApp connection status
- Get WhatsApp notification settings
- Update WhatsApp notification settings
- Get WhatsApp analytics
- List recent WhatsApp messages
- Connect merchant's own Meta WABA (BYO)
- Disconnect BYO Meta WABA and revert to platform-managed
- Get WhatsApp connection status (BYO-aware)
- Update store-level WhatsApp preferences (e.g. message language)
- Update notification toggles (BYO-path)
- Get the store's WhatsApp access-gate state
- Open (or resume) the bill for this store's WhatsApp access
- Request WhatsApp access for this store (merchant)
- List WhatsApp templates
- Create WhatsApp template
- Delete WhatsApp template
- Sync template statuses from Meta
- List registered email events
- Get registry default template for an event/language
- List merchant email templates
- Create email template override
- Get email template by ID
- Update email template
- Delete email template
- Preview an unsaved email-template draft
- Preview a saved email template
- Send a test email rendered from this template
- List conversations (inbox)
- Get unread conversation count
- Get messages for a conversation
- Send a message in a conversation
- Update conversation (mark read, archive, assign)
- List campaigns
- Create campaign draft
- Get campaign details
- Update campaign draft
- Send campaign now
- Schedule campaign
- Cancel scheduled campaign
- List campaign recipients
- Estimate audience size
- List Opt Ins
- Create Opt In
- Revoke Opt In
- List Scheduled Sends
- Create Scheduled Send
- Get Scheduled Send
- Cancel Scheduled Send
- List Dead Letters
- Get Dead Letter
- Replay Dead Letter
- Connect Meta
- Meta Callback
- Connect Assets
- Sync History
- Disconnect Channel
- List Connections
- List Threads
- Get Thread
- Mark Read
- Resolve Thread
- Link Customer
- Unlink Customer
- List Messages
- Send Message
- Create Template
- List Templates
- Online store
- List menus
- Create menu
- Get menu by handle
- Update (or create) a menu by handle
- Delete menu
- List pages
- Create page
- Get page by handle
- Update (or create) a page by handle
- Delete page
- List all themes available to a store (built-in + external)
- Submit External Theme
- Get External Theme Info
- Remove External Theme
- Connect a local theme dev server (numu-theme dev)
- Get Build Status
- Rebuild External Theme
- Validate External Theme
- List all theme installations for a store
- Install a theme on the store
- Get a specific installation
- Rename a theme installation
- Uninstall a theme from the store
- Duplicate a theme installation into a new draft copy
- Export an installation as a portable JSON document
- Activate an installed theme
- Save draft customization (not yet live)
- Publish draft customization (goes live)
- Generate a preview URL for an installation
- List the store's theme workspace files
- Read one workspace file
- Create or overwrite a workspace file
- Delete a workspace file
- Seed a buildable starter theme into the workspace
- Build & publish the code-editor workspace
- Get Draft
- Autosave Draft
- Publish
- List Versions
- Get Version Payload
- Restore Version
- Discard Draft
- Get Schemas
- Resolve Theme
- List undo entries
- Append an undo entry
- Clear undo stack
- Remove an undo entry (after applying)
- OAuth
Shipment dashboard stats
GET
https://numueg.app/api/v1/stores/{store_id}/shipments/stats
Last modified:2026-09-19 16:39:33
x-numu-scope:orders:read
Request
Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************or
Path Params
Responses
🟢200
application/json
Bodyapplication/json
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://numueg.app/api/v1/stores//shipments/stats' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Example 1
{
"success": true,
"data": {
"total": 0,
"by_status": {},
"cod_total": 0,
"cod_collected": 0,
"cod_pending": 0
},
"message": "string"
}Modified at 2026-09-19 16:39:33