List commissions

curl --request GET \
  --url https://platform.tolt.dev/v2/commissions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.tolt.dev/v2/commissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.tolt.dev/v2/commissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://platform.tolt.dev/v2/commissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.tolt.dev/v2/commissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Successfully fetched commissions",
  "data": [
    {
      "id": "comm_CTg3QD4vwurCXkXj3i9GG7vw",
      "amount": "1000",
      "currency": "usd",
      "revenue": "5000",
      "status": "approved",
      "type": "percentage",
      "source": "api",
      "partner_id": "part_NLYzgNKuSuASvrvoxNtau6SY",
      "customer_id": "cus_LBfjvtfct9pVUeLojMHiGnXv",
      "program_id": "prg_T6z8aRW3XCmvFWP972RKxpAd",
      "transaction_id": "txn_fB3egT1sKNVNu3ZYuU1ypYDA",
      "payout_id": null,
      "charge_id": "ch_R8qW2mN6kP4vT9xY",
      "charge_status": "paid",
      "is_ad_click": false,
      "is_self_referral": false,
      "approval_type": "immediate",
      "scheduled_approval_date": null,
      "created_at": "2026-10-19T10:15:19.228Z",
      "updated_at": "2026-10-19T10:15:19.228Z"
    },
    {
      "id": "comm_X85RLnefjTCNrypH4MA1PdSp",
      "amount": "1000",
      "currency": "usd",
      "revenue": "5000",
      "status": "approved",
      "type": "percentage",
      "source": "api",
      "partner_id": "part_NLYzgNKuSuASvrvoxNtau6SY",
      "customer_id": "cus_LBfjvtfct9pVUeLojMHiGnXv",
      "program_id": "prg_T6z8aRW3XCmvFWP972RKxpAd",
      "transaction_id": "txn_fB3egT1sKNVNu3ZYuU1ypYDA",
      "payout_id": null,
      "charge_id": "ch_R8qW2mN6kP4vT9xY",
      "charge_status": "paid",
      "is_ad_click": false,
      "is_self_referral": false,
      "approval_type": "immediate",
      "scheduled_approval_date": null,
      "created_at": "2026-10-01T12:00:00Z",
      "updated_at": "2026-10-01T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": "cur_WyJjcmVhdGVkX2F0IiwiMjAyNi0xMC0wMSAxMjowMDowMCswMCIsImNvbW1fWDg1UkxuZWZqVENOcnlwSDRNQTFQZFNwIl0",
  "prev_cursor": "cur_WyJjcmVhdGVkX2F0IiwiMjAyNi0xMC0xOSAxMDoxNToxOS4yMjgrMDAiLCJjb21tX0NUZzNRRDR2d3VyQ1hrWGozaTlHRzd2dyJd"
}

{
  "success": false,
  "message": "starting_after: malformed cursor",
  "code": "invalid_cursor",
  "doc_url": "https://docs.tolt.com/errors#invalid_cursor",
  "errors": [
    {
      "field": "starting_after",
      "message": "malformed cursor"
    }
  ]
}

{
  "success": false,
  "message": "Unauthorized",
  "code": "unauthorized",
  "doc_url": "https://docs.tolt.com/errors#unauthorized"
}

{
  "success": false,
  "message": "Request body exceeds 1 MB",
  "code": "payload_too_large",
  "doc_url": "https://docs.tolt.com/errors#payload_too_large"
}

{
  "success": false,
  "message": "Too many requests. Retry after the window resets.",
  "code": "rate_limited",
  "doc_url": "https://docs.tolt.com/errors#rate_limited"
}

GET

commissions

List commissions

curl --request GET \
  --url https://platform.tolt.dev/v2/commissions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.tolt.dev/v2/commissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.tolt.dev/v2/commissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://platform.tolt.dev/v2/commissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.tolt.dev/v2/commissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Successfully fetched commissions",
  "data": [
    {
      "id": "comm_CTg3QD4vwurCXkXj3i9GG7vw",
      "amount": "1000",
      "currency": "usd",
      "revenue": "5000",
      "status": "approved",
      "type": "percentage",
      "source": "api",
      "partner_id": "part_NLYzgNKuSuASvrvoxNtau6SY",
      "customer_id": "cus_LBfjvtfct9pVUeLojMHiGnXv",
      "program_id": "prg_T6z8aRW3XCmvFWP972RKxpAd",
      "transaction_id": "txn_fB3egT1sKNVNu3ZYuU1ypYDA",
      "payout_id": null,
      "charge_id": "ch_R8qW2mN6kP4vT9xY",
      "charge_status": "paid",
      "is_ad_click": false,
      "is_self_referral": false,
      "approval_type": "immediate",
      "scheduled_approval_date": null,
      "created_at": "2026-10-19T10:15:19.228Z",
      "updated_at": "2026-10-19T10:15:19.228Z"
    },
    {
      "id": "comm_X85RLnefjTCNrypH4MA1PdSp",
      "amount": "1000",
      "currency": "usd",
      "revenue": "5000",
      "status": "approved",
      "type": "percentage",
      "source": "api",
      "partner_id": "part_NLYzgNKuSuASvrvoxNtau6SY",
      "customer_id": "cus_LBfjvtfct9pVUeLojMHiGnXv",
      "program_id": "prg_T6z8aRW3XCmvFWP972RKxpAd",
      "transaction_id": "txn_fB3egT1sKNVNu3ZYuU1ypYDA",
      "payout_id": null,
      "charge_id": "ch_R8qW2mN6kP4vT9xY",
      "charge_status": "paid",
      "is_ad_click": false,
      "is_self_referral": false,
      "approval_type": "immediate",
      "scheduled_approval_date": null,
      "created_at": "2026-10-01T12:00:00Z",
      "updated_at": "2026-10-01T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": "cur_WyJjcmVhdGVkX2F0IiwiMjAyNi0xMC0wMSAxMjowMDowMCswMCIsImNvbW1fWDg1UkxuZWZqVENOcnlwSDRNQTFQZFNwIl0",
  "prev_cursor": "cur_WyJjcmVhdGVkX2F0IiwiMjAyNi0xMC0xOSAxMDoxNToxOS4yMjgrMDAiLCJjb21tX0NUZzNRRDR2d3VyQ1hrWGozaTlHRzd2dyJd"
}

{
  "success": false,
  "message": "starting_after: malformed cursor",
  "code": "invalid_cursor",
  "doc_url": "https://docs.tolt.com/errors#invalid_cursor",
  "errors": [
    {
      "field": "starting_after",
      "message": "malformed cursor"
    }
  ]
}

{
  "success": false,
  "message": "Unauthorized",
  "code": "unauthorized",
  "doc_url": "https://docs.tolt.com/errors#unauthorized"
}

{
  "success": false,
  "message": "Request body exceeds 1 MB",
  "code": "payload_too_large",
  "doc_url": "https://docs.tolt.com/errors#payload_too_large"
}

{
  "success": false,
  "message": "Too many requests. Retry after the window resets.",
  "code": "rate_limited",
  "doc_url": "https://docs.tolt.com/errors#rate_limited"
}

Authorizations

Authorization

string

header

required

Tolt API key sent as a bearer token.

Query Parameters

limit

integer

default:10

How many rows to return in one page.

Required range: 1 <= x <= 100

order

enum<string>

default:desc

Ranking direction: desc puts the most recently created or updated rows first.

Available options:

asc,

desc

sort

enum<string>

default:created_at

Timestamp to order and page by: created_at follows creation order, updated_at follows each item's most recent change.

Available options:

created_at,

updated_at

starting_after

string

Continue after a position: the next_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with ending_before.

ending_before

string

Page backward from a position: the prev_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with starting_after.

created_after

string<date-time>

Start of a window on when items were created: items created at this time or later are included, for example 2026-01-01T00:00:00Z. Leave it out for no lower bound.

created_before

string<date-time>

End of a window on when items were created: only items created before this time are included. Leave it out for no upper bound.

updated_after

string<date-time>

Only items last changed at or after this moment; with sort=updated_at, use it to fetch what changed since a previous sync.

updated_before

string<date-time>

Only items last changed before this moment; pair it with updated_after to fetch what changed in a period.

program_id

string

Limit to one program, by its id (prg_...) as returned when listing programs.

partner_id

string

Limit to one partner, by its id (part_...) as returned when listing partners.

customer_id

string

Only commissions for this customer, by Tolt customer id (cus_...) as returned when listing customers.

transaction_id

string

Only commissions linked to this transaction, by its id (txn_...).

status

string

Only commissions in this status, matched exactly, such as pending, approved or paid.

type

string

Only commissions whose type equals this stored value exactly.

string

Text matched anywhere in the commission id or its charge_id, ignoring case.

Maximum string length: 255

Response

A page of commissions

success

boolean

required

Example:

true

message

string

required

Example:

"Request successful"

data

object[]

required

Show child attributes

has_more

boolean

required

Example:

false

next_cursor

string | null

required

Opaque cursor marking the last item on this page. Pass it as starting_after to continue. Null when the page is empty.

prev_cursor

string | null

required

Opaque cursor marking the first item on this page. Pass it as ending_before to page backward. Null when the page is empty.

Basics

Partners

Links

Clicks

Customers

Transactions

Commissions

Promotion codes

Reports

Embed

Programs

Groups

Flows

List commissions

Authorizations

Query Parameters

Response