GET /info

Get information about your application, branch, and quota usage.

Endpoint

GET /info

Full URL: https://api.easyslip.com/v2/info

Authentication

Required. See Authentication Guide.

Authorization: Bearer YOUR_API_KEY

Request

No request body required.

Type Definitions

// Response Types
interface InfoResponse {
  success: true;
  data: InfoData;
  message: string;
}

interface InfoData {
  application: Application;
  branch: Branch;
  account: Account;
  product: Product;
}

interface Application {
  name: string;
  autoRenew: AutoRenew;
  quota: ApplicationQuota;
}

interface AutoRenew {
  expired: boolean;
  quota: boolean;
  createdAt: string;   // ISO 8601
  expiresAt: string;   // ISO 8601
}

interface ApplicationQuota {
  used: number;
  max: number | null;       // null = unlimited
  remaining: number | null;
  totalUsed: number;
}

interface Branch {
  name: string;
  isActive: boolean;
  quota: BranchQuota;
}

interface BranchQuota {
  used: number;
  totalUsed: number;
}

interface Account {
  email: string;
  credit: number;
}

interface Product {
  name: string;
}

// Error Response
interface ErrorResponse {
  success: false;
  error: {
    code: string;
    message: string;
  };
}

Examples

cURL

curl -X GET https://api.easyslip.com/v2/info \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch('https://api.easyslip.com/v2/info', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const result = await response.json();
console.log(result.data);

PHP

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.easyslip.com/v2/info',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

Python

import requests
import os

response = requests.get(
    'https://api.easyslip.com/v2/info',
    headers={'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}'}
)

result = response.json()
print(result['data'])

Response

Success Response (200)

{
  "success": true,
  "data": {
    "application": {
      "name": "My Application",
      "autoRenew": {
        "expired": false,
        "quota": true,
        "createdAt": "2024-01-01T00:00:00+07:00",
        "expiresAt": "2025-01-01T00:00:00+07:00"
      },
      "quota": {
        "used": 1500,
        "max": 35000,
        "remaining": 33500,
        "totalUsed": 45000
      }
    },
    "branch": {
      "name": "Main Branch",
      "isActive": true,
      "quota": {
        "used": 500,
        "totalUsed": 12000
      }
    },
    "account": {
      "email": "[email protected]",
      "credit": 5000
    },
    "product": {
      "name": "Pro Plan"
    }
  },
  "message": "Information retrieved successfully"
}

Response Fields

Field	Type	Description
application.name	string	Application name
application.autoRenew.expired	boolean	Auto-renew on expiry
application.autoRenew.quota	boolean	Auto-renew on quota exhaustion
application.autoRenew.createdAt	string	Creation timestamp (ISO 8601)
application.autoRenew.expiresAt	string	Expiration timestamp (ISO 8601)
application.quota.used	number	Quota used this period
application.quota.max	number | null	Maximum quota (null = unlimited)
application.quota.remaining	number | null	Remaining quota
application.quota.totalUsed	number	Total quota used all time
branch.name	string	Current branch name
branch.isActive	boolean	Branch active status
branch.quota.used	number	Branch quota used
branch.quota.totalUsed	number	Branch total used
account.email	string	Account email
account.credit	number	Available credit
product.name	string	Subscription plan name

Error Responses

Unauthorized (401)

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "Authorization header is required"
  }
}

Invalid API Key (401)

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

Branch Inactive (403)

{
  "success": false,
  "error": {
    "code": "BRANCH_INACTIVE",
    "message": "This API branch has been deactivated"
  }
}

Notes

• This endpoint does not consume quota
• Quota resets monthly based on your billing cycle
• max: null indicates unlimited quota
• totalUsed tracks all-time usage across all billing periods
• Branch quota is tracked separately from application quota