Skip to main content
GET
/
subscription
curl -X GET "https://api.utilsio.com/subscription?appId=app_xyz789" \
  -H "X-utilsio-Timestamp: 1704067200" \
  -H "X-utilsio-Signature: your_signature_here"

{
  "success": true,
  "subscription": {
    "id": "sub_123456",
    "amountPerDay": "1.50",
    "createdAt": "2024-01-01T12:00:00Z"
  }
}
Retrieves the active subscription for a specific device and application.

​
Authentication

This endpoint requires Signature Authentication.
The device ID is obtained from the utilsio_device cookie. If the device cookie is not present, the API returns {success: true, subscription: null} with a 200 status code.

​
Endpoint

MethodPathDescription
GET/subscriptionRetrieves the active subscription for a specific device and application

​
Request Headers

​
X-utilsio-Timestamp
string
required
Current Unix timestamp (seconds)
​
X-utilsio-Signature
string
required
HMAC-SHA256 signature

​
Query Parameters

​
appId
string
required
The unique identifier for your application.
curl -X GET "https://api.utilsio.com/subscription?appId=app_xyz789" \
  -H "X-utilsio-Timestamp: 1704067200" \
  -H "X-utilsio-Signature: your_signature_here"

​
Response

​
success
boolean
Indicates if the request was successful.
​
subscription
object
The active subscription details, or null if no subscription exists.
{
  "success": true,
  "subscription": {
    "id": "sub_123456",
    "amountPerDay": "1.50",
    "createdAt": "2024-01-01T12:00:00Z"
  }
}

​
HTTP Status Codes

StatusMeaningWhen
200SuccessSubscription found or not found (both return success: true)
401UnauthorizedMissing or invalid signature
403ForbiddenInvalid app ID
500Server ErrorInternal error occurred

Authorizations

​
X-utilsio-Signature
string
header
required

HMAC-SHA256 signature of the request.

Query Parameters

​
appId
string
required

Your utilsio Application ID

Response

Subscription retrieved successfully

​
success
boolean
​
subscription
object
​
error
string
Last modified on January 15, 2026