API Access

The Afglo API lets owners and affiliates interact with affiliate program data from backend services, scripts, dashboards, or AI agents. Owners get full read/write access. Affiliates get read-only access to their own data.

API Key Types

Generating Keys

Owner keys

1. Sign in as the program owner.
2. Open Owner dashboard → account menu → API keys.
3. Enter a label and select Create key.
4. Store the sk_ key securely. The full secret is shown once.

Affiliate keys

1. Sign in as an affiliate.
2. Call POST /api/v1/affiliate/api-key (session-authenticated).
3. Store the ak_ key securely. The full secret is shown once.

Keys can be revoked from the API keys table or settings. Revoked keys stop authenticating immediately.

Authentication

Use HTTP Basic Auth with the API key as the username and an empty password.

# Owner
curl "https://afglo.com/api/v1/campaigns" \
  -u "sk_your_api_key_here:"

# Affiliate
curl "https://afglo.com/api/v1/affiliate/campaigns" \
  -u "ak_your_api_key_here:"

Do not put API keys in browser code, mobile apps, public repositories, or client-side environment variables.

Rate Limiting

45 requests per 30-second window per key. Exceeding the limit returns HTTP 429.

Pagination

Collection endpoints support page and limit (max 100, default 25).

{
  "data": [],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total_count": 384,
    "total_pages": 16
  }
}

Filters

Date filters

Use ISO 8601 timestamps on most collection endpoints:

curl "https://afglo.com/api/v1/referrals?created_after=2026-01-01T00:00:00Z&created_before=2026-04-21T23:59:59Z" \
  -u "sk_your_api_key_here:"

Field filters

Filter by related IDs, emails, or status on supported endpoints:

• campaign_id — filter by campaign
• affiliate_id — filter by affiliate-campaign relationship
• email / customer_email — filter by email
• state — affiliate state (active, pending, disabled)
• status — commission or payout status (due, pending, paid, voided)

Expand

Use expand to include related objects inline instead of just IDs:

curl "https://afglo.com/api/v1/commissions?expand=sale,affiliate,campaign" \
  -u "sk_your_api_key_here:"

Owner Endpoints (sk_ keys)

Campaigns

Create campaign body:

{
  "name": "Summer Sale Affiliates",
  "description": "Affiliate program for summer promotion",
  "landing_page_url": "https://example.com",
  "reward_type": "percent",
  "commission_percent": 15,
  "cookie_window_days": 90,
  "minimum_payout_cents": 2000,
  "payout_delay_days": 30,
  "reward_cadence": "first_year",
  "max_commission_period_months": 12,
  "auto_approve_affiliates": true
}

reward_cadence: "first_year" applies a 12-month commission period and no max commission count.

Affiliates

Filters: campaign_id, email, state

Enroll affiliate body:

{
  "campaign_id": "campaign_id_here",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "state": "active"
}

Affiliate Links

Filters: affiliate_id, campaign_id

Referrals

Filters: affiliate_id, campaign_id, conversion_state, email, created_after, created_before

Leads

Filters: affiliate_id, campaign_id, email, created_after, created_before

Conversions

Filters: affiliate_id, campaign_id, customer_email, created_after, created_before

Commissions

Filters: affiliate_id, campaign_id, status, created_after, created_before

Update commission body:

{
  "status": "paid"
}

Payouts

Filters: affiliate_id, campaign_id, status, created_after, created_before

Analytics

Parameters: range (30d, 90d, 12m, all), campaign_id

Returns totals, trends (% change vs prior period), daily/monthly time series, source breakdown, top affiliates, and campaign breakdown.

curl "https://afglo.com/api/v1/analytics?range=30d" \
  -u "sk_your_api_key_here:"

Affiliate Endpoints (ak_ keys)

Affiliate endpoints return only data belonging to the authenticated affiliate. All are read-only.

Filters on affiliate endpoints: campaign_id, status, created_after, created_before (where applicable).

Common Queries

List your campaigns (affiliate):

curl "https://afglo.com/api/v1/affiliate/campaigns" \
  -u "ak_your_api_key_here:"

List due commissions (owner):

curl "https://afglo.com/api/v1/commissions?status=due&limit=100" \
  -u "sk_your_api_key_here:"

Enroll a new affiliate (owner):

curl -X POST "https://afglo.com/api/v1/affiliates" \
  -u "sk_your_api_key_here:" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id":"cmo2...","first_name":"Jane","last_name":"Doe","email":"jane@example.com"}'

Mark a payout as paid (owner):

curl -X POST "https://afglo.com/api/v1/payouts/payout_id/mark_as_paid" \
  -u "sk_your_api_key_here:"

Error Responses

All errors return a JSON object with an error field:

{
  "error": "Campaign not found."
}