curl -X GET "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data, pagination } = await response.json();
$ch = curl_init('https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
{
"data": [
{
"id": "V1StGXR8Z5jd",
"activated_by": {
"ip": {
"value": "203.0.113.45",
"country": {
"name": "United States",
"code": "US",
"alpha_3_code": "USA",
"dial_code": "+1",
"currency": "USD",
"flag": "https://cdn.axazara.com/flags/svg/US.svg"
}
},
"user_agent": {
"is_desktop": true,
"is_robot": false,
"platform": "OS X",
"browser": "Chrome",
"version": "120.0.0.0",
"device": "Macintosh",
"is_mobile": false,
"is_phone": false,
"is_tablet": false,
"is_ios": false,
"is_android": false
},
"device": "00:1B:44:11:3A:B7"
},
"metadata": null,
"activated_at": "2025-01-18T15:42:00.000000Z",
"created_at": "2025-01-18T15:42:00.000000Z"
},
{
"id": "Uakgb2KQ9xLm",
"activated_by": {
"ip": {
"value": "198.51.100.12",
"country": null
},
"user_agent": null,
"device": null
},
"metadata": null,
"activated_at": "2025-01-16T09:15:00.000000Z",
"created_at": "2025-01-16T09:15:00.000000Z"
}
],
"pagination": {
"count": 2,
"path": "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations",
"per_page": 20,
"next_cursor": null,
"next_page_url": null,
"prev_cursor": null,
"prev_page_url": null,
"has_more_pages": false,
"has_pages": false
}
}
{
"message": "License key not found.",
"errors": []
}
Licenses
Get License Activations
Retrieve activation history for a license
curl -X GET "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data, pagination } = await response.json();
$ch = curl_init('https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
{
"data": [
{
"id": "V1StGXR8Z5jd",
"activated_by": {
"ip": {
"value": "203.0.113.45",
"country": {
"name": "United States",
"code": "US",
"alpha_3_code": "USA",
"dial_code": "+1",
"currency": "USD",
"flag": "https://cdn.axazara.com/flags/svg/US.svg"
}
},
"user_agent": {
"is_desktop": true,
"is_robot": false,
"platform": "OS X",
"browser": "Chrome",
"version": "120.0.0.0",
"device": "Macintosh",
"is_mobile": false,
"is_phone": false,
"is_tablet": false,
"is_ios": false,
"is_android": false
},
"device": "00:1B:44:11:3A:B7"
},
"metadata": null,
"activated_at": "2025-01-18T15:42:00.000000Z",
"created_at": "2025-01-18T15:42:00.000000Z"
},
{
"id": "Uakgb2KQ9xLm",
"activated_by": {
"ip": {
"value": "198.51.100.12",
"country": null
},
"user_agent": null,
"device": null
},
"metadata": null,
"activated_at": "2025-01-16T09:15:00.000000Z",
"created_at": "2025-01-16T09:15:00.000000Z"
}
],
"pagination": {
"count": 2,
"path": "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations",
"per_page": 20,
"next_cursor": null,
"next_page_url": null,
"prev_cursor": null,
"prev_page_url": null,
"has_more_pages": false,
"has_pages": false
}
}
{
"message": "License key not found.",
"errors": []
}
Fetches a cursor-paginated list of all activation records for a specific license, ordered by most recent first. Each activation record contains detailed information about when and where the license was activated, including IP address, user agent, device identifier, and timestamp.
This endpoint is useful for auditing license usage, tracking device activations, and debugging activation-related issues. The response includes pagination metadata; the activation totals are on the licence itself.
Required scope:
licenses.read. A key without it receives a 403 error. See Authentication.Path Parameters
string
required
The licence key to retrieve activations for (e.g.,
ABC-123-XYZ-789)Query Parameters
integer
default:"10"
Number of activation records to return per page (max 100)
string
Cursor for pagination. Use the
next_cursor from the previous response.Response
The list is returned at the top level of the body, without themessage and errors fields used by error responses.
array
Array of activation records, most recent first
Show activation object
Show activation object
string
Activation public ID
object
Who activated the licence
Show properties
Show properties
object
value is the IP address of the activation request. country holds its name, code, alpha_3_code, dial_code, currency and flag, or is null when the IP cannot be located.object | null
Parsed user agent:
browser, version, platform, device, and the booleans is_desktop, is_mobile, is_phone, is_tablet, is_robot, is_ios and is_android. null when the request sent no user agent.string | null
The
device_identifier sent on activation, if anyobject | null
Additional metadata attached to the activation
string
ISO 8601 timestamp of the activation
string
ISO 8601 timestamp when the record was created
object
Cursor pagination metadata
Show pagination object
Show pagination object
integer
Number of items on this page
string
Base URL of the endpoint
integer
Page size used for this request
string | null
Cursor for the next page, or
null if there are no more pagesstring | null
Full URL of the next page, or
nullstring | null
Cursor for the previous page, or
null on the first pagestring | null
Full URL of the previous page, or
nullboolean
Whether there are more items to fetch
boolean
Whether the results span more than one page
The activation totals live on the licence itself: read
activations.count, activations.max and activations.remaining from Get License.curl -X GET "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data, pagination } = await response.json();
$ch = curl_init('https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations?per_page=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
{
"data": [
{
"id": "V1StGXR8Z5jd",
"activated_by": {
"ip": {
"value": "203.0.113.45",
"country": {
"name": "United States",
"code": "US",
"alpha_3_code": "USA",
"dial_code": "+1",
"currency": "USD",
"flag": "https://cdn.axazara.com/flags/svg/US.svg"
}
},
"user_agent": {
"is_desktop": true,
"is_robot": false,
"platform": "OS X",
"browser": "Chrome",
"version": "120.0.0.0",
"device": "Macintosh",
"is_mobile": false,
"is_phone": false,
"is_tablet": false,
"is_ios": false,
"is_android": false
},
"device": "00:1B:44:11:3A:B7"
},
"metadata": null,
"activated_at": "2025-01-18T15:42:00.000000Z",
"created_at": "2025-01-18T15:42:00.000000Z"
},
{
"id": "Uakgb2KQ9xLm",
"activated_by": {
"ip": {
"value": "198.51.100.12",
"country": null
},
"user_agent": null,
"device": null
},
"metadata": null,
"activated_at": "2025-01-16T09:15:00.000000Z",
"created_at": "2025-01-16T09:15:00.000000Z"
}
],
"pagination": {
"count": 2,
"path": "https://api.chariow.com/v1/licenses/ABC-123-XYZ-789/activations",
"per_page": 20,
"next_cursor": null,
"next_page_url": null,
"prev_cursor": null,
"prev_page_url": null,
"has_more_pages": false,
"has_pages": false
}
}
{
"message": "License key not found.",
"errors": []
}
Use Cases
Audit Trail
Track all devices that have activated a licence:async function getActivationHistory(licenseKey) {
const response = await fetch(
`https://api.chariow.com/v1/licenses/${licenseKey}/activations`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data } = await response.json();
data.forEach(activation => {
console.log(`Device: ${activation.activated_by.device}`);
console.log(`IP: ${activation.activated_by.ip.value}`);
console.log(`Date: ${activation.activated_at}`);
});
return data;
}
Device Management
Display activation history to customers:async function showCustomerActivations(licenseKey) {
const response = await fetch(
`https://api.chariow.com/v1/licenses/${licenseKey}/activations`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data } = await response.json();
return data.map(a => ({
name: a.activated_by.device || 'Unknown Device',
ip: a.activated_by.ip.value,
country: a.activated_by.ip.country?.name,
activatedAt: new Date(a.activated_at).toLocaleDateString()
}));
}
Fraud Detection
Identify suspicious activation patterns:async function detectSuspiciousActivity(licenseKey) {
const response = await fetch(
`https://api.chariow.com/v1/licenses/${licenseKey}/activations?per_page=100`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { data } = await response.json();
// Check for activations from many different IP addresses
const uniqueIPs = new Set(data.map(a => a.activated_by.ip.value));
if (uniqueIPs.size > 5) {
console.warn('Suspicious: License activated from multiple IP addresses');
}
return {
suspicious: uniqueIPs.size > 5,
uniqueLocations: uniqueIPs.size,
activations: data
};
}
Pagination
This endpoint uses cursor-based pagination for efficient traversal of large activation lists:async function getAllActivations(licenseKey) {
let allActivations = [];
let cursor = null;
do {
const url = cursor
? `https://api.chariow.com/v1/licenses/${licenseKey}/activations?cursor=${cursor}`
: `https://api.chariow.com/v1/licenses/${licenseKey}/activations`;
const response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const { data, pagination } = await response.json();
allActivations = [...allActivations, ...data];
cursor = pagination.next_cursor;
} while (cursor);
return allActivations;
}
Notes
- Activations are ordered by most recent first (
activated_at, then creation order) - Each activation is immutable and cannot be modified
- Activation records persist even after a licence is revoked
activated_by.deviceisnullif nodevice_identifierwas sent during activation- IP addresses and user agents are automatically captured during activation
Was this page helpful?