View your AFFILIFY data via API

1. Sign in → Settings → API access → generate a key. Copy it immediately (shown once).
2. Call any endpoint below with Authorization: Bearer YOUR_KEY over HTTPS.
3. Parse the JSON — every success body has ok: true.

curl -H "Authorization: Bearer affa_…" \
  "https://affilify.partners/api/v1/stats/summary?days=30"

Keys start with affa_. We store only a hash — if you lose the raw key, revoke it and create a new one.

Pass the key with either header (both work):

Authorization: Bearer affa_…
# or
X-API-Key: affa_…

Do not put the key in public front-end code or shared repos.

Totals for the last N days, plus a previous window of equal length (for deltas). Matches the Statistics page.

{
  "ok": true,
  "days": 30,
  "has_revshare": true,
  "clicks": 24,
  "registrations": 1,
  "ftds": 0,
  "deposits_count": 0,
  "deposits_sum": 0,
  "ngr": 0,
  "conversions": 1,
  "commission": 0,
  "previous": { "clicks": 8, "registrations": 0, "ftds": 0, "…" : "…" }
}

Inclusive date range with per-day rows — same chart data as the dashboard date picker.

Response includes totals, previous, and daily[] with date, clicks, registrations, ftds, ngr, commission. Max range 366 days.

Last 24 hours in UTC hour buckets. Use this for the same “24h” view as Statistics.

Returns totals, previous (prior 24h), and hourly[] where each row has ts (bucket start) plus metrics.

Click volume by country for a lookback window, plus proxy share.

{
  "ok": true,
  "days": 30,
  "total_clicks": 24,
  "proxy_clicks": 17,
  "countries": 3,
  "top_countries": [
    { "country": "GB", "clicks": 17 },
    { "country": "CY", "clicks": 5 },
    { "country": "DE", "clicks": 2 }
  ]
}

Recent events on your links — registrations, FTDs, deposits, NGR, etc. Brand/operator company names are not included; link + campaign id are.

{
  "ok": true,
  "count": 1,
  "conversions": [{
    "id": "…",
    "event_type": "registration",
    "amount": 0,
    "currency": "USD",
    "status": "approved",
    "created_at": "2026-07-07T16:24:23Z",
    "is_test": false,
    "sub_ids": { "sub_id1": "…", "sub_id2": null },
    "link": { "id": "…", "code": "6c1ia02o", "name": "goon", "campaign_id": "…" }
  }]
}

Active brands you can promote (same catalogue as Brands in the app), and GEO/landing rows used when creating a link.

Landings return id, country, name (no raw destination URLs). Pass a landing id when creating a link.

{
  "ok": true,
  "campaign_id": "…",
  "landings": [
    { "id": "…", "country": "GB", "name": "Bonus", "sort_order": 2, "is_default": false }
  ]
}

List and manage tracking links. Each link (list, get and create) includes blocked and a ready-to-share tracking_url (/go/{code} on the same link domain the dashboard shows; null once the link is deactivated, see below). Sub-IDs are query params when you share the URL — not stored on the link.

{
  "ok": true,
  "count": 14,
  "links": [{
    "id": "…",
    "code": "dhxjnue0",
    "name": "test",
    "status": "active",
    "blocked": false,
    "tracking_url": "https://…/go/dhxjnue0",
    "clicks_count": 0,
    "conversions_count": 0,
    "commission_earned": 0,
    "campaign": { "id": "…", "name": "CASINACHO", "image_url": "…" }
  }]
}

curl -X POST -H "Authorization: Bearer affa_…" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id":"…","landing_id":"…","name":"DE FB"}' \
  "https://affilify.partners/api/v1/links"

Create uses the same rules as the dashboard (application, KYC, CPA gates). A blocked create returns link_gate with a message.

status is active or paused. AFFILIFY can deactivate a link: it then has blocked: true, status paused and tracking_url: null, and it no longer sends visitors anywhere. A deactivated link can't be deleted, restored or reactivated (link_blocked); its stats stay available.

All bodies are JSON with an ok flag.