Get account

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

string

required

Bearer sk_live_…. See Authentication.

Response

number

The Telegram user id linked to the account that owns the key.

number

Current credit balance. Each resolve spends credits per the provider’s tier; cached resolves are free.

string | null

ISO 8601 timestamp of when the active subscription ends, or null if there is no subscription.

object[]

The providers available on this account.

Show provider object

string

Provider id, e.g. ouo.

string

Human-readable provider name, e.g. Ouo.

string

"standard" or "premium".

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"

const account = await client.account();

console.log(`Balance: ${account.balance} credits`);
console.log(`Providers: ${account.providers.map((p) => p.provider).join(", ")}`);
if (account.subscriptionUntil) {
  console.log(`Subscribed until ${account.subscriptionUntil}`);
}

<?php

$account = $client->account();

printf("Balance: %d credits\n", $account->balance);
echo "Providers: " . implode(", ", array_map(
    fn ($p) => $p->provider,
    $account->providers,
)) . PHP_EOL;
if ($account->subscriptionUntil !== null) {
    echo "Subscribed until " . $account->subscriptionUntil . PHP_EOL;
}

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.

Get started

API

Reference

SDKs

Request

Headers

Response

Examples

​Request

​Headers

​Response

​Examples

Request

Headers

Response

Examples