Get Subscriber Details
Retrieve detailed information about a specific subscriber including contact details and payment history.
Get Subscriber Details
Version: 3.0.0
Generate an API Key for the Subscription channel before making requests.
Use this endpoint to retrieve detailed information about a specific subscriber. The response includes the subscriber's contact details, creation date, and a complete list of their associated payments.
Endpoint
| Method | URL |
|---|---|
| GET | https://api.payorc.com/subscriptions/v1/subscriber/details |
Please use the test credentials for sandbox testing.
Authentication
Include the following headers in every request:
| Header | Type | Description |
|---|---|---|
merchant-key | String | Your merchant key |
merchant-secret | String | Your merchant secret |
All API requests must be made over HTTPS. Requests made over plain HTTP will be rejected.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
data_id | String | Yes | Encrypted subscriber identifier from Subscriber List (data[].data_id). |
Use data_id from Subscriber List — not the plain subscriber_id display number.
Response (200 OK)
| Field | Type | Description |
|---|---|---|
data | Object | Subscriber details object |
data.data_id | String | Encrypted subscriber identifier (same value used in API requests) |
data.subscribers_id | String | Plain display subscriber number |
data.name | String | Subscriber name |
data.email | String | Subscriber email address |
data.mobile_no | String | Subscriber mobile number |
data.country_code | String | Country code |
data.created_date | String | Date created (DD-MM-YYYY HH:mm:ss) |
data.payment_list | Array | List of payments associated with the subscriber |
data.payment_list[].order_id | String | Order ID |
data.payment_list[].order_amount | String | Order amount (includes currency prefix, e.g., AED 1.00) |
data.payment_list[].order_currency | String | Order currency (e.g., AED) |
data.payment_list[].status | String | Payment status (e.g., FAILED, CAPTURED) |
data.payment_list[].transaction_date | String | Transaction date (DD-MM-YYYY HH:mm:ss) |
data.payment_list[].address | String | Address associated with the payment |
message | String | Human-readable status message |
status | String | success or error |
code | String | Status code (00 for success) |
Code Examples
curl -X GET "https://api.payorc.com/subscriptions/v1/subscriber/details?data_id=QU9IdGRnM1VyZ2" \
-H "merchant-key: YOUR_MERCHANT_KEY" \
-H "merchant-secret: YOUR_MERCHANT_SECRET"Example Response
{
"data": {
"data_id": "QU9IdGRnM1VyZ2",
"subscribers_id": "0000000248",
"name": "Rahul S",
"email": "[email protected]",
"mobile_no": "9238328673",
"country_code": "91",
"created_date": "23-01-2024 10:34:07",
"payment_list": [
{
"order_id": "1000010252",
"order_amount": "AED 1.00",
"order_currency": "AED",
"status": "FAILED",
"transaction_date": "23-01-2024 10:34:07",
"address": "Address, Nagpur, IND"
}
]
},
"message": "Details fetched successfully.",
"status": "success",
"code": "00"
}The data_id can be obtained from the Subscriber List endpoint. Use it to fetch the full details of any subscriber.