Verify Trial

Updated 10 September 2026

POST `?action=verify_trial`

Validates a trial code and returns the associated activation context. Use this to power a trial upgrade flow — verify the code first, then pass the activation_id and selected product to create_renewal.

Request Parameters

Field	Type	Required	Description
`trial_code`	string	Requiredone of these two	Trial code issued to the customer
`activation_token`	string	Requiredone of these two	The long token from the trial's own links — what Panelr's trial-upgrade redirect hands your store as `?t=…`

Response Fields

Field	Type	Description
`trial_request_id`	integer	Trial request ID
`activation_id`	integer	Activation ID linked to this trial
`customer_email`	string	Customer email address
`customer_name`	string	Customer full name
`expiration_date`	string\|null	Trial expiration datetime UTC
`connections`	integer	Number of connections on the current trial line
`eligible_products`	array	Active non-trial products available for upgrade — see Product Object below. Only plans from the same service as the line — a renewal cannot cross services

Product Object

Field	Type	Description
`id`	integer	Product ID
`name`	string	Product name
`alternate_name`	string\|null	Alternate display name
`price_decimal`	float	Product price
`currency`	string	Currency code e.g. USD
`duration_months`	integer	Subscription duration in months
`connections`	integer	Number of simultaneous connections

Example request

$ch = curl_init('PANELR_API_URL?action=verify_trial');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode(['trial_code' => 'TRL-ABC123']),
    CURLOPT_HTTPHEADER     => [
        'X-Panelr-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST "PANELR_API_URL?action=verify_trial" \
  -H "X-Panelr-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trial_code": "TRL-ABC123"}'

const res = await fetch('PANELR_API_URL?action=verify_trial', {
  method: 'POST',
  headers: {
    'X-Panelr-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ trial_code: 'TRL-ABC123' }),
});
const { data } = await res.json();

import requests
r = requests.post('PANELR_API_URL',
    params={'action': 'verify_trial'},
    headers={'X-Panelr-API-Key': 'YOUR_API_KEY'},
    json={'trial_code': 'TRL-ABC123'})
data = r.json()['data']

POST ?action=verify_trial

Request Parameters

Response Fields

Product Object

POST `?action=verify_trial`