Skip to main content
GET https://api.linkskipper.app/v1/account · Any valid API key.
Returns the account behind the API key: the linked Telegram identity, current credit balance, subscription expiry (if any), and the list of providers available to you. Useful for showing a balance in your dashboard or gating a resolve before you spend a credit.

​
Request

​
Headers

​
Authorization
string
required
Bearer sk_live_…. See Authentication.

​
Response

​
telegram_id
number
The Telegram user id linked to the account that owns the key.
​
balance
number
Current credit balance. Each resolve spends credits per the provider’s tier; cached resolves are free.
​
subscription_until
string | null
ISO 8601 timestamp of when the active subscription ends, or null if there is no subscription.
​
providers
object[]
The providers available on this account.
200 OK
{
  "telegram_id": 123456789,
  "balance": 248,
  "subscription_until": null,
  "providers": [
    { "provider": "aylink", "label": "Aylink", "tier": "standard" },
    { "provider": "linktl", "label": "LinkTL", "tier": "standard" },
    { "provider": "ouo", "label": "Ouo", "tier": "standard" },
    { "provider": "exe", "label": "Exe.io", "tier": "premium" }
  ]
}

​
Examples

curl https://api.linkskipper.app/v1/account \
  -H "Authorization: Bearer sk_live_XXXXXXXXXXXXXXXXXXXXXXXX"
The provider list here mirrors GET /v1/providers but omits the hosts, per-call cost, and latency. Use the providers endpoint when you need the full catalog detail.