This will allow you to retrieve the information related to a particular recurring payment subscription in Kartra.
Type | Parameters | Values |
POST | cmd* | get_subscription_details |
POST | subscription_id* | integer |
* Required fields Here is an example:
'actions' => [
'0' => [
'cmd' => 'get_subscription_details',
'subscription_id' => 993037
]
]
Here are the results returned by the request:
Parameters | Values |
subscription_details | String (JSON encoded string containing the details of the recurring payment subscription) |
JSON parameters | Values |
subscription_id | integer A unique numeric identifier for the subscription id. |
subscription_product_id | integer Product id of the subscription. |
subscription_price_point | integer Product price point number of the subscription. |
subscription_lead_id | integer Id for the lead linked to the subscription. |
subscription_start_date | yyyy-mm-dd hh:mm:ss Subscription start date EST. |
subscription_end_date | yyyy-mm-dd hh:mm:ss Subscription end date EST (0000-00-00 00:00:00 if subscription is not cancelled or terminated). |
subscription_current_installment | integer Number of the current installment. |
subscription_installments_left | integer How many installments are left / string "Until cancelled" |
subscription_recurring_period | string ("monthly", "every 2 months", "quarterly","yearly", "every 2 years", "weekly", "every 2 weeks") The type of recurring for the subscription. |
subscription_status | string ("Active", "Paused", "Cancelled", "Terminated") Subscription status. |
subscription_next_payment_date | yyyy-mm-dd hh:mm:ss Subscription next payment date EST. |
subscription_next_scheduled_payment_amount | float The amount of the next scheduled payment. "N/A" if none. |
subscription_affiliate | string Username of the affiliate, "N/A" if none. |
subscription_jv | string Username of the jv, "N/A" if none. |
Example of the returned JSON array:{
"get_subscription_details":{
"subscription_details":{
"subscription_id":"993037",
"subscription_product_id":"213",
"subscription_price_point":"2",
"subscription_lead_id":"321",
"subscription_start_date":"2021-01-07 11:14:00",
"subscription_end_date":"0000-00-00 00:00:00",
"subscription_current_installment":"1",
"subscription_installments_left":"Until cancelled",
"subscription_recurring_period":"monthly",
"subscription_status":"Active",
"subscription_next_payment_date":"2021-02-07 11:14:00",
"subscription_next_scheduled_payment_amount":"22.19",
"subscription_affiliate":"affiliate_username",
"subscription_jv":"N/A"
}
}
}
Error Cases:
Type Number | Message | Cause |
248 | Subscription doesn't exist | - The subscription you are trying to find does not exist in our database.
|
An example of an error message:
{
"status": "Error",
"message": "Subscription doesn't exist",
"type": 248
}