Sign in
Cashback Rules

List Cashback Rules

Lists all cashback rules funded by the authenticated platform account. Includes scheduled, expired, and discarded rules. Requires payout:transfer:read. Account-scoped credentials are required; there is no caller-supplied funding-account filter.

get/cashback_rules

Query parameters

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'created_at'

Field to sort by. Defaults to created_at.

direction'asc' | 'desc'

Sort direction. Defaults to desc.

Response

cashback rules listed

Example response

{
  "data": [
    {
      "created_at": "2026-01-01T12:00:00.000Z",
      "description": "Cloud cashback",
      "expires_at": "2026-01-01T12:00:00.000Z",
      "funding_account_id": "biz_xxxxxxxxxxxxxx",
      "id": "cicbr_xxxxxxxxxxxxxx",
      "merchant_category_code": "7372",
      "merchant_name": "ACME CLOUD",
      "rate_bps": 500,
      "scoped_account_id": "biz_xxxxxxxxxxxxxx",
      "starts_at": "2026-01-01T12:00:00.000Z",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ]
}

Changes