List Fraud Events

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&event_type=SELF_REFERRAL&search=alice&page=1&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "cmevent123abc",
      "event_type": "SELF_REFERRAL",
      "status": "PENDING",
      "description": "Self-referral",
      "metadata": {
        "originalReferralStatus": "LEAD"
      },
      "internal_note": null,
      "resolution": null,
      "resolved_at": null,
      "resolved_note": null,
      "created_at": "2024-01-20T15:30:00.000Z",
      "referral_id": "ref_456def",
      "referral_email": "alice@example.com",
      "resolved_by": null,
      "affiliate": {
        "id": "aff_789ghi",
        "name": "Alice Partner",
        "email": "alice@example.com",
        "country": "US",
        "status": "ACTIVE",
        "total_fraud_events": 1,
        "pending_commission": 0
      },
      "program": {
        "id": "prog_123",
        "name": "Demo Program"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  },
  "pending_count": 4,
  "resolved_count": 2,
  "auto_blocked_count": 1
}

GET

fraud-events

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&event_type=SELF_REFERRAL&search=alice&page=1&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "cmevent123abc",
      "event_type": "SELF_REFERRAL",
      "status": "PENDING",
      "description": "Self-referral",
      "metadata": {
        "originalReferralStatus": "LEAD"
      },
      "internal_note": null,
      "resolution": null,
      "resolved_at": null,
      "resolved_note": null,
      "created_at": "2024-01-20T15:30:00.000Z",
      "referral_id": "ref_456def",
      "referral_email": "alice@example.com",
      "resolved_by": null,
      "affiliate": {
        "id": "aff_789ghi",
        "name": "Alice Partner",
        "email": "alice@example.com",
        "country": "US",
        "status": "ACTIVE",
        "total_fraud_events": 1,
        "pending_commission": 0
      },
      "program": {
        "id": "prog_123",
        "name": "Demo Program"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  },
  "pending_count": 4,
  "resolved_count": 2,
  "auto_blocked_count": 1
}

Lists Risk Center fraud events for the authenticated team. Requires the read:affiliates permission.

Summary counts (pending_count, resolved_count, auto_blocked_count) ignore search and status. They stay team-wide for the selected event_type.

Query Parameters

integer

default:"1"

Page number for pagination. Must be a positive integer. Default is 1.

integer

default:"50"

Number of results per page. Minimum value is 1, maximum value is 200. Default is 50.

string

default:"PENDING"

Filter by event status. Valid values: PENDING (queue), RESOLVED (cleared or auto-blocked). Default is PENDING.

string

Filter by fraud rule type. Valid values: SELF_REFERRAL, CROSS_PROGRAM_BAN, DUPLICATE_PAYOUT_METHOD, SUSPICIOUS_EMAIL_DOMAIN, BANNED_REFERRAL_SOURCE, PAID_TRAFFIC, BLOCKED_COUNTRY.

string

Case-insensitive match on referral email or affiliate name/email.

Response

The response includes a paginated list of fraud events, pagination metadata, and team-wide summary counts.

boolean

Always true for successful responses

array

Array of fraud event objects.

Show Data Object Properties

string

Unique identifier for the fraud event

string

Fraud rule type. Valid values: SELF_REFERRAL, CROSS_PROGRAM_BAN, DUPLICATE_PAYOUT_METHOD, SUSPICIOUS_EMAIL_DOMAIN, BANNED_REFERRAL_SOURCE, PAID_TRAFFIC, BLOCKED_COUNTRY.

string

Event status. Valid values: PENDING, RESOLVED.

string | null

Human-readable description of the event. Can be null.

object

Event-specific metadata payload

string | null

Internal note on the event. Can be null.

string | null

How the event was closed. Valid values: AUTO_BLOCKED, RESOLVED, CONFIRMED_FRAUD, or null while pending.

string | null

ISO 8601 timestamp of when the event was resolved. Can be null.

string | null

Merchant note stored on the resolution. Can be null.

string

ISO 8601 timestamp of when the event was created

string | null

Related referral ID. Can be null.

string | null

Related referral email. Can be null.

object | null

Dashboard user who resolved the event. null for API callers.

Show resolved_by Properties

string

User ID

string | null

User display name. Can be null.

string | null

User email. Can be null.

object | null

Related affiliate. Can be null.

Show affiliate Properties

string

Affiliate ID

string | null

Affiliate display name. Can be null.

string | null

Affiliate contact email. Can be null.

string | null

Affiliate invoice country. Can be null.

string

Affiliate status

integer

Count of this affiliate’s fraud events that are not marked resolution RESOLVED

number

Sum of the affiliate’s pending and ready-for-payment commission credit

object | null

Related program. Can be null.

Show program Properties

string

Program ID

string | null

Program name. Can be null.

object

Pagination metadata object containing:

page (integer): Current page number
limit (integer): Number of results per page
total (integer): Total number of events matching the filters
total_pages (integer): Total number of pages
has_next_page (boolean): Whether there is a next page
has_prev_page (boolean): Whether there is a previous page

integer

Team-wide count of PENDING events for the selected event_type. Ignores search and status.

integer

Team-wide count of reviewed events (RESOLVED and not AUTO_BLOCKED) for the selected event_type. Ignores search and status.

integer

Team-wide count of AUTO_BLOCKED events for the selected event_type. Ignores search and status.

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/fraud-events?status=PENDING&event_type=SELF_REFERRAL&search=alice&page=1&limit=20" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "cmevent123abc",
      "event_type": "SELF_REFERRAL",
      "status": "PENDING",
      "description": "Self-referral",
      "metadata": {
        "originalReferralStatus": "LEAD"
      },
      "internal_note": null,
      "resolution": null,
      "resolved_at": null,
      "resolved_note": null,
      "created_at": "2024-01-20T15:30:00.000Z",
      "referral_id": "ref_456def",
      "referral_email": "alice@example.com",
      "resolved_by": null,
      "affiliate": {
        "id": "aff_789ghi",
        "name": "Alice Partner",
        "email": "alice@example.com",
        "country": "US",
        "status": "ACTIVE",
        "total_fraud_events": 1,
        "pending_commission": 0
      },
      "program": {
        "id": "prog_123",
        "name": "Demo Program"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4,
    "total_pages": 1,
    "has_next_page": false,
    "has_prev_page": false
  },
  "pending_count": 4,
  "resolved_count": 2,
  "auto_blocked_count": 1
}

Getting Started

Guide

Core Resources

Program Management

Marketplace

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response