# GET /commissions — List Commissions

> Product: **Pabbly Subscription Billing** (v1)
> Base URL: `https://payments.pabbly.com/api/v1`
> Auth: Basic via `Authorization` header
> Canonical: `/subscription-billing/affiliate-modules/list-commissions`

This API is used to retrieve a list of all the available commissions.

**Query parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| affiliate_id | string | No | List commission by Affiliate ID. |
| limit | string | No | Integer, default=10, min=1, max=100 The number of resources to be returned. |
| page | string | No | By default first page will be listed. For navigating through pages, use the page parameter. |

**Response (200)** — List Commissions:

```json
{
    "status": "success",
    "message": "Commission data",
    "data": [
        {
            "id": "602f701df5a9824fd1c2213e",
            "product_name": "Nafees Testing",
            "invoice_number": "INV-2090",
            "invoice_id": "602f7019f5a9824fd1c22136",
            "commission_amount": 49.9,
            "status": "Unpaid",
            "createdAt": "2021-02-19T08:00:29.224Z",
            "updatedAt": "2021-02-19T08:00:29.224Z",
            "payout_date": "",
            "affiliate_id": "602f6e84f5a9824fd1c22119",
            "affiliate_email": "pabblytest@inboxkitten.com",
            "customer_email": "mayanktidke+test488@gmail.com",
            "is_paid": "no",
            "currency": "$",
            "click_id": "602f7003f5a9824fd1c22133",
            "is_void": false,
            "plan_id": "5fc1fc89aa1e5f68820aa758"
        },
        {
            "id": "602b1b6b79fcfe38536661f6",
            "product_name": "Paddle",
            "invoice_number": "INV-2068",
            "invoice_id": "602b1b6979fcfe38536661dc",
            "commission_amount": 5,
            "status": "Paid",
            "createdAt": "2021-02-16T01:10:03.984Z",
            "updatedAt": "2021-02-16T01:10:03.984Z",
            "payout_date": "2021-02-16T01:10:04.044Z",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "mayanktidke+domaintest@gmail.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "5ee7ab715de0cb59ca1f2bb1",
            "is_void": false,
            "plan_id": "5ee4d591f912ba55cede69d5"
        },
        {
            "id": "6027ac505694207fb549627c",
            "product_name": "Product B",
            "invoice_number": "INV-2053",
            "invoice_id": "6027ac4d5694207fb5496274",
            "commission_amount": 5.9,
            "status": "Refunded",
            "createdAt": "2021-02-13T10:39:12.511Z",
            "updatedAt": "2021-02-13T10:40:01.525Z",
            "payout_date": "",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "mayanktidke@gmail.com",
            "is_paid": "no",
            "currency": "$",
            "click_id": "6027ac3c5694207fb5496272",
            "is_void": true,
            "plan_id": "5eec9f8416d9f631c71eb022"
        },
        {
            "id": "60226d8a769cba2dd4c0c300",
            "product_name": "Product B",
            "invoice_number": "INV-2022",
            "invoice_id": "60226d8a769cba2dd4c0c2d6",
            "commission_amount": 15.9,
            "status": "Paid",
            "createdAt": "2021-02-09T11:10:02.721Z",
            "updatedAt": "2021-02-09T11:11:01.657Z",
            "payout_date": "2021-02-09T11:10:03.033Z",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "satya@inboxkitten.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "5fe05b5c99748b4a7e884bb6",
            "is_void": false,
            "plan_id": "5f4f810cca1c5e149c11b444"
        },
        {
            "id": "60226d8a769cba2dd4c0c2ff",
            "product_name": "Product B",
            "invoice_number": "INV-2023",
            "invoice_id": "60226d89769cba2dd4c0c2d5",
            "commission_amount": 15.9,
            "status": "Paid",
            "createdAt": "2021-02-09T11:10:02.685Z",
            "updatedAt": "2021-02-09T11:11:01.665Z",
            "payout_date": "2021-02-09T11:10:04.044Z",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "satya@inboxkitten.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "5fe05b5c99748b4a7e884bb6",
            "is_void": false,
            "plan_id": "5f4f810cca1c5e149c11b444"
        },
        {
            "id": "601d43ac58ffd0698ad0b160",
            "product_name": "Testing Product",
            "invoice_number": "INV-1997",
            "invoice_id": "601d43aa58ffd0698ad0b13b",
            "commission_amount": 5,
            "status": "Unpaid",
            "createdAt": "2021-02-05T13:10:04.179Z",
            "updatedAt": "2021-02-05T13:10:04.179Z",
            "payout_date": "",
            "affiliate_id": "5f7af1ea7917da0310f35f55",
            "affiliate_email": "mayanktidke+fresttestaff@gmail.com",
            "customer_email": "mayanktidke+commision589@gmail.com",
            "is_paid": "no",
            "currency": "$",
            "click_id": "5f7af4b17917da0310f35f89",
            "is_void": false,
            "plan_id": "5ee4d477f912ba55cede69aa"
        },
        {
            "id": "6019b19b7535c3244799def0",
            "product_name": "Form Plans",
            "invoice_number": "INV-1971",
            "invoice_id": "6019b1997535c3244799ded7",
            "commission_amount": 10,
            "status": "Paid",
            "createdAt": "2021-02-02T20:10:03.997Z",
            "updatedAt": "2021-02-02T20:11:01.786Z",
            "payout_date": "2021-02-02T20:10:04.044Z",
            "affiliate_id": "5eba2a38b070f62c4f3c8107",
            "affiliate_email": "mayanktidke+afftest26@gmail.com",
            "customer_email": "mayanktidke+testing7894566@gmail.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "5efc68a6830cce69f718516f",
            "is_void": false,
            "plan_id": "5ee9ebcf5de0cb59ca1f4690"
        },
        {
            "id": "6019b19b7535c3244799deed",
            "product_name": "Form Plans",
            "invoice_number": "INV-1969",
            "invoice_id": "6019b1997535c3244799decf",
            "commission_amount": 10,
            "status": "Paid",
            "createdAt": "2021-02-02T20:10:03.573Z",
            "updatedAt": "2021-02-02T20:11:01.737Z",
            "payout_date": "2021-02-02T20:10:05.055Z",
            "affiliate_id": "5eba2a38b070f62c4f3c8107",
            "affiliate_email": "mayanktidke+afftest26@gmail.com",
            "customer_email": "mayanktidke+testi5958989589595@gmail.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "5efc68a6830cce69f718516f",
            "is_void": false,
            "plan_id": "5ee9ebcf5de0cb59ca1f4690"
        },
        {
            "id": "601916ed7535c3244799d41c",
            "product_name": "test",
            "invoice_number": "INV-1960",
            "invoice_id": "601916ea7535c3244799d3cc",
            "commission_amount": 2,
            "status": "Paid",
            "createdAt": "2021-02-02T09:10:05.137Z",
            "updatedAt": "2021-02-02T09:11:02.118Z",
            "payout_date": "2021-02-02T09:10:06.066Z",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "mayanktidke+test46925558955@gmail.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "",
            "is_void": false,
            "plan_id": "5f912e979ede59558fab0ab5"
        },
        {
            "id": "601916ec7535c3244799d419",
            "product_name": "test",
            "invoice_number": "INV-1961",
            "invoice_id": "601916ea7535c3244799d3cd",
            "commission_amount": 2,
            "status": "Paid",
            "createdAt": "2021-02-02T09:10:04.848Z",
            "updatedAt": "2021-02-02T09:11:02.179Z",
            "payout_date": "2021-02-02T09:10:05.055Z",
            "affiliate_id": "5e511a687afb28735caace68",
            "affiliate_email": "mayanktidke+affiliatetest@gmail.com",
            "customer_email": "mayanktidke+appltest1@gmail.com",
            "is_paid": "yes",
            "currency": "$",
            "click_id": "",
            "is_void": false,
            "plan_id": "5f912e979ede59558fab0ab5"
        }
    ]
}
```

**Code examples:**

_cURL_

```curl
curl https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}} \
  -u {{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}
```

_Ruby_

```ruby
require 'net/http'
require 'json'

uri = URI('https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}')
request = Net::HTTP::Get.new(uri)
request.basic_auth '{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

_Python_

```python
import requests
from requests.auth import HTTPBasicAuth

response = requests.get(
    'https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}',
    auth=HTTPBasicAuth('{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'),
)

data = response.json()
```

_PHP_

```php
<?php
$ch = curl_init('https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, '{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}');

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
```

_Java_

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

String credentials = Base64.getEncoder().encodeToString("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}".getBytes());

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}"))
    .header("Authorization", "Basic " + credentials)
    .GET();

HttpRequest request = builder.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

_Node.js_

```node
const credentials = Buffer.from('{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}').toString('base64');

const response = await fetch('https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}', {
  method: 'GET',
  headers: {
    'Authorization': `Basic ${credentials}`,
  },
});

const data = await response.json();
```

_Go_

```go
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}", nil)
    req.SetBasicAuth("{{YOUR_API_KEY}}", "{{YOUR_SECRET_KEY}}")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
```

_.NET_

```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}"));

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://payments.pabbly.com/api/v1/commissions?affiliate_id={{affiliate_id}}&limit={{limit}}&page={{page}}");
request.Headers.TryAddWithoutValidation("Authorization", $"Basic {credentials}");

var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```

---

**Other endpoints in Affiliate Modules:**

- [POST /commissions/create — Create Commission](/subscription-billing/affiliate-modules/create-commission)
- [PUT /commissions/{{commissionId}} — Update Commission](/subscription-billing/affiliate-modules/update-commission)
- [GET /commissions/clicks — Affiliate Clicks](/subscription-billing/affiliate-modules/affiliate-clicks)
- [DELETE /commissions/clicks/{{click_id}} — Delete Clicks](/subscription-billing/affiliate-modules/delete-clicks)
- [POST /affiliate/payout/generate — Create Manual Report](/subscription-billing/affiliate-modules/create-manual-report)
- [GET /affiliate/links — Affiliate Links](/subscription-billing/affiliate-modules/affiliate-links)
- [POST /affiliate/commissionrule/create — Create Commission Rule](/subscription-billing/affiliate-modules/create-commission-rule)
- [PUT /affiliate/status/{{id}} — Update Affiliate Status](/subscription-billing/affiliate-modules/update-affiliate-status)

