Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
- Create your First App
- Embedded Apps
- App Scripts
- App APIs
- 🗂️ Overview
- 🔁 Changelog
- 🚀 Start Here
- Responses
- Rate Limiting
- Webhooks
- Authorization
- APIs
- Orders
- Reverse Orders
- Abandoned Carts
- Products
- Inventories
- Shipping
- Marketing
- Gift Cards
- Coupons
- Bundle Offers
- Loyalty Program
- Calculate Loyalty Points for Order
- Retrieve Store Loyalty Status
- Activate Loyalty Program
- Retrieve Loyalty Program Status
- Set Points Expiration Rules
- Update Cashback Rule
- Update Cashback Rule Status
- Create Points Redemption Method
- Update Points Redemption Method
- Delete Points Redemption Method
- Update Redemption Method Status
- Retrieve Customer Loyalty Summary
- List Loyalty Data
- List Customer Points History
- Retrieve Manager Loyalty Info Page
- Update Loyalty Info Page
- Adjust Customer Points
- Customers
- Store Settings
- Countries and Cities
- Webhook
- Events
- App Subscriptions
Subscription Details
GET
https://api.zid.sa/v1/market/app/subscription
🔑Scopes
Subscription.read - Subscription ReadRequest
Header Params
Body Params application/x-www-form-urlencoded
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.zid.sa/v1/market/app/subscription' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--header 'Accept: application/json' \
--data-urlencode 'app_id=123'Responses
🟢200OK
application/json
Body
Example
{
"status": "object",
"subscription": {
"app_id": 2376,
"store_id": 26520,
"store_url": "https://example.zidtest.com/",
"plan_name": "1استخدام",
"subscription_status": "active",
"start_date": "2025-02-04T15:55:07.000000Z",
"end_date": null,
"merchant_phone_no": "+201063989603",
"merchant_email": "m.example@zid.sa",
"is_usage_based": 1,
"pending_charges": 100,
"settled_charges": 1,
"charges": [
{
"id": "9eaac8b0-3530-4bdb-b2fb-34b4efe22179",
"subscription_id": 333,
"amount": 300,
"amount_details": {
"amount": 34500,
"currency": "SAR",
"formatted": "ر.س 345.00"
},
"status": "pending",
"overdue_at": null,
"created_at": "2025-04-13T16:58:06.000000Z"
}
]
},
"message": {
"type": "object",
"code": null,
"name": null,
"description": "Store subscription details of the provided token"
}
}🟠401Unauthorized
🔴500Internal Server error
Modified at 2026-02-06 13:05:19