Zid Docs
Apps
ThemesPayments
Apps
ThemesPayments
Help Center
Slack
  1. Customers
  • πŸ—‚οΈ Overview
  • πŸš€ Start Here
  • Create your First App
  • Responses
  • Rate Limiting
  • Authorization
  • Zid App Activation & OAuth Policy
  • Embedded Apps
  • StoreFront Events
  • Zid MUI
  • Zid SDKs
  • Our custom MCP server
  • Zid AI Agent Skill
  • Merchant APIs
    • Account
      • Me
        • Me
      • Store
        • Store
        • Branding
        • Localization
        • Social
        • Operations
        • Business
        • Upload Logo Image
        • Delete Logo Image
        • Upload Icon Image
        • Delete Icon Image
        • Upload Cover Image
        • Delete Cover Image
    • Orders
      • Order Tags
        • List Order Tags
        • Create Order Tag
      • Validate Order Request
      • Create Order
      • Change Order Status
      • Add Order Comment
      • View Order
      • List Orders
      • List Custom Order Statuses
      • List Order Credit Notes
      • Get Orders Highlights
      • Order Fulfillment Inventories
      • Bulk Create/Update Custom Order Statuses
    • Reverse Orders
      • Create Reverse Orders
      • Create Reverse Orders Waybill
      • Add Reverse Order Reasons
      • List Reverse Reasons
      • Calculate Reverse Totals
      • Create refund for reverse order
      • Upload bank transfer receipt
      • Update return products
      • Order Details – View for Return
    • Abandoned Carts
      • List Carts
      • View Cart
      • Validate Abandoned Cart Messages
      • Send Abandoned Cart Notification Manually
    • Products
      • Managing Products
        • Create Product Types
        • Create Product
        • List Products
        • View Product
        • List Product Settings
        • Update Product
        • Bulk Update Products
        • Delete Product
      • Digital Vouchers
        • List Vouchers
        • Order Vouchers
        • Create Voucher
        • Import Vouchers
        • Export Vouchers
        • Update Voucher
        • Remove Voucher
      • Product Categories
        • List Categories
        • View Category
        • Create Category
        • Create Subcategory
        • Update Category
        • Assign Product to Category
        • Bulk Assign Products to Category
        • Publish Category
        • Detach Category from All Products
        • Remove Product from Category
        • Set Categories Nesting
        • Delete Category Cover Image
        • Upload Category Cover Image
        • Delete Category
        • Delete Category Image
        • Upload Category Image
        • Update Category
      • Product Brands
        • List Brands
        • Single Brand
      • Product Badge
        • List Badges
      • Product Attributes
        • List Attributes
        • View Attribute
        • Create Attribute
        • Update Attribute
        • Delete Attribute
      • Product Attribute Presets
        • List Presets
        • Create Preset
        • Update Preset
        • Delete Preset
      • Product Variants
        • Create Variants
        • Create Custom Option
        • Update Custom Option
        • Delete Custom Option Field
        • Create Custom Input Field
        • Update Custom Input Field
        • Delete Custom Input Field
      • Product Sorting
        • Set Manual Product Order
        • Reset Manual Product Order
      • Product Images
        • List Images
        • Upload Image
        • Update Image Order
        • Delete Image
      • Product Availability Notifications
        • Notification Stats
        • Noticiation Settings
        • List Notifications
        • Create Notification
        • Update Settings
        • Send Notification Email
        • Export Notifications
      • Product Export
        • Email All Products to Store Owner
        • Import Products via CSV or xlsx File
      • Product Stock
        • Retrieve Product Stock
        • List Product Stock Records
        • Create Product Stock
        • Update Product Stock
        • Bulk Update Product Stock Records
      • Product Questions & Answers
        • Retrieve Product Question
        • Retrieve Product Answer
        • List Product Questions
        • List Answers for Question
        • Create Product Question
        • Create Product Answer
        • Update Product Question
        • Update Product Answer
        • Delete Product Question
        • Delete Product Answer
        • List Store Product Questions
      • Product Reviews
        • List Reviews
        • Count Reviews
      • Digital Products
        • Create Downloadable Product
        • Generate Upload URL
        • Upload File to S3
        • Create Product Downloadable
        • Get Product Downloadables
        • Delete Product Downloadable
        • List Store Downloadables
        • Create Store Downloadable
        • Delete Store Downloadable
    • Inventories
      • Create Location
      • Update Location
      • Update Product Stock for Location
      • List Locations
      • View Location
    • Shipping
      • List Store Shipping Methods
    • Marketing
      • Coupons
        • List Coupons
        • View Coupon
        • Create Coupon
        • Generate Bulk Coupons
        • Duplicate Coupon
        • Duplicate Bulk Coupons
        • Update Coupon Note
        • Update Coupon
        • Update Bulk Coupons
        • Update Coupon Status
        • Update Bulk Coupons Status
        • Delete Coupon
        • Delete Bulk Coupons
      • Bundle Offers
        • List Bundle Offers
        • View Bundle Offer
        • Create Bundle Offer
        • Update Bundle Offer
        • Delete Bundle Offer
        • Bulk Delete Bundle Offers
      • Loyalty Program
        • Loyalty Program Status
        • Loyalty Program Details
        • Loyalty Program Info
        • Customer Loyalty Summary
        • Customer Points History
        • Activate Loyalty Program
        • Set Points Expiration Rules
        • Update Cashback Rule
        • Create Points Redemption Method
        • Update Points Redemption Method
        • Delete Points Redemption Method
        • Adjust Customer Points
        • Update Redemption Method Status
        • Loyalty Program Analytics
        • Loyalty Program Settings
      • Customer Wallets
        • Cashback Rules
          • List Cashback Rules
          • Create Cashback Rule
          • Retrieve Cashback Rule
          • Update Cashback Rule
          • Delete Cashback Rule
        • Wallet Analytics
          • Get Wallet Analytics
          • Get Wallet Analytics by Rule
        • Manager Customer Wallet
          • List Customer Wallets
          • Bulk Credit Customer Wallets
          • Bulk Debit Customer Wallets
          • Export Customer Wallets
          • Get Customer Wallet Balance
          • Credit Customer Wallet
          • Debit Customer Wallet
          • Customer Pending Cashbacks
          • Customer Wallet Transactions
    • Customers
      • Customer Tags
        • List Customer Tags
        • Add Customer Tag
        • Ω’Update Customer Tag
        • Delete Customer Tag
      • Customer Portal Tickets
        • List Customer Portal Tickets
        • Customer Portal Ticket Detail
      • List Customers
        GET
      • View Customer
        GET
      • Primary Customer List
        GET
      • FInd Customer By Phone Number
        GET
      • Customer Profile
        GET
      • Add Customer
        POST
      • Update Customer
        PUT
      • Delete Customer
        DELETE
      • Add Bulk Customers
        POST
      • Import Customers
        POST
    • Store Settings
      • πŸ“„ User Roles and Permissions
      • Retrieve Store Manager Profile
      • Retrieve VAT Settings
      • List Payment Methods
      • List Store Operating Countries
      • OneSignal Store Settings
      • Create or Update OneSignal Store Settings
      • Get Payment Options
    • Countries and Cities
      • List Countries
      • List Cities for Country
    • Blogs
      • Settings
        • Create
        • List
      • Categories
        • Create
        • List
        • Bulk Activate
        • Bulk Deactivate
        • Bulk Delete
        • Retrieve
        • Destroy
        • Partial Update
        • Bulk Add To Posts
        • Bulk Remove From Posts
        • Bulk Delete Blog Categories
      • Posts
        • Media
          • List
          • Create
          • Destroy
        • Create
        • List
        • Retrieve
        • Partial Update
        • Destroy
        • Archive
        • Publish
        • Bulk Archive
        • Bulk Publish
        • Bulk Delete
        • Export Posts
        • Import Template
        • Import Posts
      • Tags
        • Create
        • List
        • Retrieve
        • Partial Update
        • Destroy
        • Bulk Delete Tags
        • Bulk Add To Posts
        • Bulk Remove From Posts
      • Storefront
        • Posts
          • List
          • Retrieve
        • Categories
          • List
          • Retrieve
        • Tags
          • List
  • Webhooks
    • Overview
    • Webhook Health Tracking
    • Events
      • Order
      • Product
      • Abandoned Cart
      • Customer
      • Product Category
    • APIs
      • Health Summary
      • Broken Webhooks
      • Recover Broken Webhooks
      • List Webhooks
      • Create Webhook
      • Delete Webhook
      • Delete Webhook By subscriber
  • App Management
    • Events
    • APIs
      • Subscription Details
      • Update Usage-Based Charges
  1. Customers

Customer Profile

GET
https://api.zid.sa/v1/managers/store/customers/{customerId}/profile
Retrieves a detailed customer data from a store's customer list
πŸ”‘Scopes
third_customers_read - Customers Read

Request

Path Params

Header Params

Responses

🟒200OK
application/json
Bodyapplication/json

🟠401Unauthorized
πŸ”΄500Internal Server error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/managers/store/customers/23862/profile' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'
Response Response Example
200 - Success
{
    "status": "object",
    "customer": {
        "id": 37,
        "name": "Osama Khaled",
        "mobile": "966503187423",
        "email": "osamakhaled2010@gmail.com",
        "gender": "male",
        "birth_date": "1987-05-05T00:00:00.000000Z",
        "note": null,
        "verified": true,
        "is_active": true,
        "is_newsletter_subscriber": false,
        "type": "individual",
        "tax_number": null,
        "commercial_registration": null,
        "business_name": null,
        "is_cod_enabled": true,
        "registration_date": "2022-03-09T07:54:51.000000Z",
        "last_login_at": "2026-07-01T17:48:07.000000Z",
        "source": "pos",
        "groups": {
            "customer_groups": [
                {
                    "id": "c1aa6b4d-ace7-474b-aec7-c5ded77175e7",
                    "store_id": "d297fb8b-c322-412e-a2f4-ffa96dc57022",
                    "name": "KSA, UAE",
                    "description": ""
                },
                {
                    "id": "c1aa6b4d-ace7-474b-aec7-c5ded77175e7",
                    "store_id": "d297fb8b-c322-412e-a2f4-ffa96dc57022",
                    "name": "KSA, UAE",
                    "description": ""
                }
            ]
        },
        "tags": [],
        "orders_count": 979,
        "total_payments": 549010.0430658805,
        "orders_cost_average": 560.786560843596,
        "latest_orders": [
            {
                "id": 71538942,
                "invoice_number": 71538942,
                "code": "i4MKiY8IG6",
                "store_id": 3,
                "order_url": "https://osama.zid.store/o/i4MKiY8IG6/inv",
                "store_name": "Ω…ΨͺΨ¬Ψ± Ψ£Ψ³Ψ§Ω…Ψ©.",
                "shipping_method_code": "zid_zidship.aramex_drop_off",
                "store_url": "https://osama.zid.store/",
                "order_status": {
                    "name": "ΨͺΨ¬Ω‡ΩŠΨ²",
                    "code": "preparing"
                },
                "display_status": {
                    "id": 2,
                    "code": "preparing",
                    "color": "#f39c12",
                    "name": "ΨͺΨ¬Ω‡ΩŠΨ²"
                },
                "currency_code": "SAR",
                "customer": {
                    "id": 37,
                    "name": "Osama Khaled",
                    "email": "osamakhaled2010@gmail.com",
                    "mobile": "966503187423",
                    "note": "",
                    "type": "individual"
                },
                "has_different_consignee": 0,
                "is_guest_customer": 0,
                "is_gift_order": 0,
                "gift_card_details": null,
                "is_quick_checkout_order": false,
                "order_total": "99.99999948169900",
                "order_total_string": "100.00 SAR",
                "has_different_transaction_currency": false,
                "transaction_reference": null,
                "transaction_amount": 99.999999481699,
                "transaction_amount_string": "100.00 SAR",
                "issue_date": "06-07-2026 | 11:28 Ψ΅",
                "payment_status": "paid",
                "is_potential_fraud": false,
                "source": "Ω„ΩˆΨ­Ψ© Ψ§Ω„ΨͺΨ­ΩƒΩ…",
                "source_code": "md",
                "is_reseller_transaction": false,
                "created_at": "2026-07-06 09:28:11",
                "updated_at": "2026-08-02 08:21:27",
                "is_on_demand": false,
                "import_id": null,
                "point_type": null,
                "tags": [],
                "marketing_source": {
                    "utm_id": "",
                    "utm_source": "",
                    "utm_medium": "",
                    "utm_campaign": "",
                    "utm_term": "",
                    "utm_content": "",
                    "referer": "organic",
                    "referer_code": null,
                    "platform": "desktop_web",
                    "device_type": "desktop",
                    "browser": "Chrome",
                    "os": "OS X",
                    "ip": "192.168.161.246",
                    "ip_country": "SA",
                    "ip_continent": null,
                    "ip_city": null,
                    "ip_region": null,
                    "ip_timezone": null,
                    "click_ids": null,
                    "click_timeline": null,
                    "visitor_id": null
                },
                "requires_shipping": false,
                "should_merchant_set_shipping_method": false,
                "products": [
                    {
                        "id": "a1477bb2-72ea-4be9-b2cf-093cefc721bb",
                        "order_product_id": 123564362,
                        "parent_id": null,
                        "parent_name": null,
                        "parent_sku": null,
                        "product_class": "voucher",
                        "name": "voucher",
                        "short_description": {
                            "ar": "",
                            "en": ""
                        },
                        "sku": "Z.1770805225810645",
                        "barcode": null,
                        "custom_fields": [],
                        "quantity": 1,
                        "weight": null,
                        "is_taxable": true,
                        "is_discounted": false,
                        "meta": null,
                        "is_external_product": false,
                        "discounts": [],
                        "net_price_with_additions": 86.956521288434,
                        "net_price_with_additions_string": "86.96 SAR",
                        "price_with_additions": 99.999999481699,
                        "price_with_additions_string": "100.00 SAR",
                        "net_price": 86.956521288434,
                        "net_price_string": "86.96 SAR",
                        "net_sale_price": null,
                        "net_sale_price_string": null,
                        "net_additions_price": 0,
                        "net_additions_price_string": null,
                        "gross_price": 99.999999481699,
                        "gross_price_string": "100.00 SAR",
                        "gross_sale_price": null,
                        "gross_sale_price_string": null,
                        "discount_percentage": 0,
                        "tax_percentage": 0.15,
                        "tax_amount": "13.04347819326500",
                        "tax_amount_string": "13.04 SAR",
                        "tax_amount_string_per_item": "13.04 SAR",
                        "discounted_tax_amount": 13.0434781932651,
                        "discounted_tax_amount_string": "13.04 SAR",
                        "discounted_tax_amount_string_per_item": "13.04 SAR",
                        "price": 99.999999481699,
                        "price_string": "100.00 SAR",
                        "additions_price": 0,
                        "additions_price_string": "0.00 SAR",
                        "total": 99.999999481699,
                        "total_string": "100.00 SAR",
                        "discounted_total": 99.9999994816991,
                        "discounted_total_string": "100.00 SAR",
                        "images": [
                            {
                                "id": "static",
                                "origin": "https://media.zid.store/static/missing_image.png",
                                "thumbs": {
                                    "fullSize": "https://media.zid.store/static/missing_image.png",
                                    "thumbnail": "https://media.zid.store/static/missing_image.png",
                                    "small": "https://media.zid.store/static/missing_image.png",
                                    "medium": "https://media.zid.store/static/missing_image.png",
                                    "large": "https://media.zid.store/static/missing_image.png"
                                }
                            },
                            {
                                "id": "static",
                                "origin": "https://media.zid.store/static/missing_image.png",
                                "thumbs": {
                                    "fullSize": "https://media.zid.store/static/missing_image.png",
                                    "thumbnail": "https://media.zid.store/static/missing_image.png",
                                    "small": "https://media.zid.store/static/missing_image.png",
                                    "medium": "https://media.zid.store/static/missing_image.png",
                                    "large": "https://media.zid.store/static/missing_image.png"
                                }
                            }
                        ],
                        "options": [],
                        "inventory_allocations": [],
                        "review_url": "https://osama.zid.store/products/7367c8e2-ab39-416b-8780-ba1cd668c8ce/reviews/new"
                    }
                ],
                "products_count": 1,
                "products_sum_total_string": "100.00 SAR",
                "is_preorder": false,
                "is_preorder_allocated": true,
                "language": "ar",
                "is_reactivated": false,
                "return_policy": "ojghwriojgbwriojgwergiou",
                "packages_count": 1,
                "edits_count": 0,
                "delivered_at": "2026-07-06 09:30:51",
                "is_marketplace_order": false,
                "invoice_link": "https://zid-platform.s3-accelerate.amazonaws.com/public/pdfs/3/orders/invoices/order_71538942.pdf",
                "payment_network": null,
                "cashback": null,
                "preorder_campaign": null,
                "nd_cashback": null,
                "nd2026": null
            }
        ],
        "points": 64,
        "pending_points": 0,
        "pending_negative_points": 0,
        "available_poitns": 64,
        "used_poitns": 6949,
        "total_positive_points": 7013
    },
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}
Modified atΒ 2026-10-01 10:43:25
Previous
FInd Customer By Phone Number
Next
Add Customer
Built with