List Commissions

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&status=ready_for_payment&sales_status=complete" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&expand=affiliate,referral" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z",
      "affiliate": {
        "id": "aff_789ghi",
        "name": "John Doe",
        "email": "john@example.com",
        "tracking_id": "PARTNER123",
        "source": "api",
        "partnership_status": "APPROVED",
        "onboarding_completed": true,
        "group_id": null,
        "created_at": "2024-01-15T10:30:00Z"
      },
      "referral": {
        "id": "ref_456def",
        "affiliate_id": "aff_789ghi",
        "email": "customer@example.com",
        "customer_id": "cust_123",
        "subscription_id": null,
        "status": "customer",
        "created_at": "2024-01-18T12:00:00Z",
        "converted_at": "2024-01-18T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

GET

commissions

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&status=ready_for_payment&sales_status=complete" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&expand=affiliate,referral" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z",
      "affiliate": {
        "id": "aff_789ghi",
        "name": "John Doe",
        "email": "john@example.com",
        "tracking_id": "PARTNER123",
        "source": "api",
        "partnership_status": "APPROVED",
        "onboarding_completed": true,
        "group_id": null,
        "created_at": "2024-01-15T10:30:00Z"
      },
      "referral": {
        "id": "ref_456def",
        "affiliate_id": "aff_789ghi",
        "email": "customer@example.com",
        "customer_id": "cust_123",
        "subscription_id": null,
        "status": "customer",
        "created_at": "2024-01-18T12:00:00Z",
        "converted_at": "2024-01-18T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

Query Parameters

integer

default:"1"

Page number for pagination. Must be a positive integer.

integer

default:"50"

Number of results per page. Maximum value is 200. Default is 50.

string

Filter commissions by affiliate ID. Only returns commissions for the specified affiliate.

string

Filter commissions by referral ID. Only returns commissions for the specified referral.

string

Filter commissions by commission status. Valid values: pending, pending_manual_approval, ready_for_payment, paid, declined.

string

Filter commissions by sales/transaction status. Valid values: open, complete, trialing, failed, refunded, partial_refunded.

string

Comma-separated list of related data to include. Valid values: affiliate, affiliate_program, referral. You can combine multiple values: affiliate,referral.

string

Filter commissions created on or after this date. ISO 8601 date-time format (e.g., 2024-01-01T00:00:00Z).

string

Filter commissions created on or before this date. ISO 8601 date-time format (e.g., 2024-12-31T23:59:59Z).

Response

The response includes a paginated list of commissions and pagination metadata.

boolean

Always true for successful responses

array

Array of commission objects. Each commission object has the same structure as the single commission response (see Get Commission endpoint).

Show Data Object Properties

string

Unique identifier for the commission

string

The referral ID this commission is associated with

string

The affiliate ID who will receive this commission

number

The total sale/transaction amount (automatically converted to team currency if different)

string

The currency code for the sale (3 letters, e.g., USD, EUR). Represents the team’s currency after conversion if applicable.

number

The commission amount to be paid

string | null

The currency code for the commission amount. Can be null when the transaction exists without an affiliate earning.

string

The commission status. Valid values: pending (on hold period, auto-updates to ready_for_payment when period expires), pending_manual_approval (same as pending but requires manual approval), ready_for_payment (approved and ready for payout in next cycle, not yet paid), paid (confirmed and already paid out), declined (rejected, not paid and excluded from payouts).

string

The sales/transaction status. Valid values: open (sale is open/pending), complete (sale completed successfully), trialing (customer is in trial period), failed (sale failed), refunded (sale fully refunded), partial_refunded (sale partially refunded).

integer | null

Number of days commission is on hold before becoming available for payment

string | null

Payment intent ID if provided

string | null

Invoice ID if linked to a payout invoice

string

ISO 8601 timestamp of when the commission was created

string

ISO 8601 timestamp of when the commission was last updated

object

Pagination metadata object containing:

page (integer): Current page number
limit (integer): Number of results per page
total (integer): Total number of commissions 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

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&status=ready_for_payment&sales_status=complete" \
  -H "Authorization: Bearer sk_live_your_api_key"

curl -X GET "https://api.affonso.io/v1/commissions?limit=10&expand=affiliate,referral" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

{
  "success": true,
  "data": [
    {
      "id": "com_abc123",
      "referral_id": "ref_456def",
      "affiliate_id": "aff_789ghi",
      "sale_amount": 99.00,
      "sale_amount_currency": "USD",
      "commission_amount": 9.90,
      "commission_currency": "USD",
      "status": "ready_for_payment",
      "sales_status": "complete",
      "hold_period_days": null,
      "payment_intent_id": null,
      "invoice_id": null,
      "created_at": "2024-01-20T15:30:00Z",
      "updated_at": "2024-01-20T15:30:00Z",
      "affiliate": {
        "id": "aff_789ghi",
        "name": "John Doe",
        "email": "john@example.com",
        "tracking_id": "PARTNER123",
        "source": "api",
        "partnership_status": "APPROVED",
        "onboarding_completed": true,
        "group_id": null,
        "created_at": "2024-01-15T10:30:00Z"
      },
      "referral": {
        "id": "ref_456def",
        "affiliate_id": "aff_789ghi",
        "email": "customer@example.com",
        "customer_id": "cust_123",
        "subscription_id": null,
        "status": "customer",
        "created_at": "2024-01-18T12:00:00Z",
        "converted_at": "2024-01-18T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 50,
    "total_pages": 5,
    "has_next_page": true,
    "has_prev_page": false
  }
}

Getting Started

Guide

Core Resources

Program Management

Marketplace

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response