> ## Documentation Index > Fetch the complete documentation index at: https://dub.co/llms.txt > Use this file to discover all available pages before exploring further. # List all commissions > Retrieve a paginated list of commissions for your partner program. ## OpenAPI ````yaml get /commissions openapi: 3.0.3 info: title: Dub API description: >- Dub is the modern link attribution platform for short links, conversion tracking, and affiliate programs. version: 0.0.1 contact: name: Dub Support email: support@dub.co url: https://dub.co/support license: name: AGPL-3.0 license url: https://github.com/dubinc/dub/blob/main/LICENSE.md servers: - url: https://api.dub.co description: Production API security: [] paths: /commissions: get: tags: - Commissions summary: List all commissions description: Retrieve a paginated list of commissions for your partner program. operationId: listCommissions parameters: - in: query name: type schema: description: >- Filter the list of commissions by type. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `sale`, `sale,lead`, `-click`. type: string enum: - click - lead - sale - referral - custom description: >- Filter the list of commissions by type. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `sale`, `sale,lead`, `-click`. - in: query name: customerId schema: description: Filter the list of commissions by the associated customer. type: string description: Filter the list of commissions by the associated customer. - in: query name: payoutId schema: description: Filter the list of commissions by the associated payout. type: string description: Filter the list of commissions by the associated payout. - in: query name: partnerId schema: description: >- Filter the list of commissions by the associated partner. When specified, takes precedence over `tenantId`. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `partner_abc`, `partner_abc,partner_xyz`, `-partner_abc`. type: string description: >- Filter the list of commissions by the associated partner. When specified, takes precedence over `tenantId`. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `partner_abc`, `partner_abc,partner_xyz`, `-partner_abc`. - in: query name: tenantId schema: description: >- Filter the list of commissions by the associated partner's `tenantId` (their unique ID within your database). type: string description: >- Filter the list of commissions by the associated partner's `tenantId` (their unique ID within your database). - in: query name: groupId schema: description: >- Filter the list of commissions by the associated partner group. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `group_abc`, `group_abc,group_xyz`, `-group_abc`. type: string description: >- Filter the list of commissions by the associated partner group. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `group_abc`, `group_abc,group_xyz`, `-group_abc`. - in: query name: partnerTagId schema: description: >- Filter the list of commissions by the associated partner tag. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `ptag_abc`, `ptag_abc,ptag_xyz`, `-ptag_abc`. type: string description: >- Filter the list of commissions by the associated partner tag. Supports advanced filtering: single value, multiple values (comma-separated), or exclusion (prefix with `-`). Examples: `ptag_abc`, `ptag_abc,ptag_xyz`, `-ptag_abc`. - in: query name: invoiceId schema: description: >- Filter the list of commissions by the associated invoice. Since invoiceId is unique on a per-program basis, this will only return one commission per invoice. type: string description: >- Filter the list of commissions by the associated invoice. Since invoiceId is unique on a per-program basis, this will only return one commission per invoice. - in: query name: status schema: description: Filter the list of commissions by their corresponding status. type: string enum: - pending - processed - paid - refunded - duplicate - fraud - canceled description: Filter the list of commissions by their corresponding status. - in: query name: sortBy schema: default: createdAt description: The field to sort the list of commissions by. type: string enum: - createdAt - amount description: The field to sort the list of commissions by. - in: query name: sortOrder schema: default: desc description: The sort order for the list of commissions. type: string enum: - asc - desc description: The sort order for the list of commissions. - in: query name: interval schema: default: all description: The interval to retrieve commissions for. type: string enum: - 24h - 7d - 30d - 90d - 1y - mtd - qtd - ytd - all description: The interval to retrieve commissions for. - in: query name: start schema: description: The start date of the date range to filter the commissions by. type: string description: The start date of the date range to filter the commissions by. - in: query name: end schema: description: The end date of the date range to filter the commissions by. type: string description: The end date of the date range to filter the commissions by. - in: query name: timezone schema: type: string - in: query name: endingBefore schema: description: >- If specified, the query only searches for results before this cursor. Mutually exclusive with `startingAfter`. example: cm_1KAP4CGN2Z5TPYYQ1W4JEYD56 type: string description: >- If specified, the query only searches for results before this cursor. Mutually exclusive with `startingAfter`. - in: query name: startingAfter schema: description: >- If specified, the query only searches for results after this cursor. Mutually exclusive with `endingBefore`. example: cm_1KAP4CGN2Z5TPYYQ1W4JEYD56 type: string description: >- If specified, the query only searches for results after this cursor. Mutually exclusive with `endingBefore`. - in: query name: page schema: description: DEPRECATED. Use `startingAfter` instead. example: 1 deprecated: true type: number minimum: 0 exclusiveMinimum: true description: DEPRECATED. Use `startingAfter` instead. - in: query name: pageSize schema: default: 100 description: The number of items per page. example: 50 type: number minimum: 0 exclusiveMinimum: true maximum: 100 description: The number of items per page. responses: '200': description: The list of commissions. content: application/json: schema: type: array items: type: object properties: id: type: string description: The commission's unique ID on Dub. example: cm_1JVR7XRCSR0EDBAF39FZ4PMYE type: type: string enum: - click - lead - sale - referral - custom amount: type: number earnings: type: number currency: type: string status: type: string enum: - pending - processed - paid - refunded - duplicate - fraud - canceled invoiceId: nullable: true type: string description: nullable: true type: string quantity: type: number userId: description: The user who created the manual commission. nullable: true type: string createdAt: type: string updatedAt: type: string partner: type: object properties: id: type: string description: The partner's unique ID on Dub. name: type: string maxLength: 190 description: The partner's full legal name. email: nullable: true description: >- The partner's email address. Should be a unique value across Dub. type: string maxLength: 190 image: nullable: true description: The partner's avatar image. type: string payoutsEnabledAt: nullable: true description: The date when the partner enabled payouts. type: string country: nullable: true description: The partner's country (required for tax purposes). type: string groupId: description: The partner's group ID on Dub. nullable: true type: string required: - id - name - email - image - payoutsEnabledAt - country additionalProperties: false customer: nullable: true type: object properties: id: type: string description: >- The unique ID of the customer. You may use either the customer's `id` on Dub (obtained via `/customers` endpoint) or their `externalId` (unique ID within your system, prefixed with `ext_`, e.g. `ext_123`). name: description: Name of the customer. nullable: true type: string email: description: Email of the customer. nullable: true type: string avatar: description: Avatar URL of the customer. nullable: true type: string externalId: type: string description: >- Unique identifier for the customer in the client's app. stripeCustomerId: description: >- The customer's Stripe customer ID. This is useful for attributing recurring sale events to the partner who referred the customer. nullable: true type: string country: description: Country of the customer. nullable: true type: string sales: description: Total number of sales for the customer. nullable: true type: number saleAmount: description: Total amount of sales for the customer. nullable: true type: number createdAt: description: >- The date the customer was created (usually the signup date or trial start date). type: string firstSaleAt: description: >- The date the customer made their first sale. Useful for calculating the time to first sale and LTV. nullable: true type: string subscriptionCanceledAt: description: >- The date the customer canceled their subscription. Useful for calculating LTV and churn rate. nullable: true type: string required: - id - externalId - createdAt additionalProperties: false required: - id - amount - earnings - currency - status - invoiceId - description - quantity - createdAt - updatedAt - partner additionalProperties: false '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '409': $ref: '#/components/responses/409' '410': $ref: '#/components/responses/410' '422': $ref: '#/components/responses/422' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' security: - token: [] x-codeSamples: - lang: python label: listCommissions source: |- from dub import Dub with Dub( token="DUB_API_KEY", ) as d_client: res = d_client.commissions.list(request={ "ending_before": "cm_1KAP4CGN2Z5TPYYQ1W4JEYD56", "starting_after": "cm_1KAP4CGN2Z5TPYYQ1W4JEYD56", "page": 1, "page_size": 50, }) while res is not None: # Handle items res = res.next() - lang: php label: listCommissions source: |- declare(strict_types=1); require 'vendor/autoload.php'; use Dub; use Dub\Models\Operations; $sdk = Dub\Dub::builder() ->setSecurity( 'DUB_API_KEY' ) ->build(); $request = new Operations\ListCommissionsRequest( endingBefore: 'cm_1KAP4CGN2Z5TPYYQ1W4JEYD56', startingAfter: 'cm_1KAP4CGN2Z5TPYYQ1W4JEYD56', page: 1, pageSize: 50, ); $responses = $sdk->commissions->list( request: $request ); foreach ($responses as $response) { if ($response->statusCode === 200) { // handle response } } - lang: go label: listCommissions source: "package main\n\nimport(\n\t\"context\"\n\tdubgo \"github.com/dubinc/dub-go\"\n\t\"github.com/dubinc/dub-go/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := dubgo.New(\n dubgo.WithSecurity(\"DUB_API_KEY\"),\n )\n\n res, err := s.Commissions.List(ctx, operations.ListCommissionsRequest{\n EndingBefore: dubgo.Pointer(\"cm_1KAP4CGN2Z5TPYYQ1W4JEYD56\"),\n StartingAfter: dubgo.Pointer(\"cm_1KAP4CGN2Z5TPYYQ1W4JEYD56\"),\n Page: dubgo.Pointer[float64](1.0),\n PageSize: dubgo.Pointer[float64](50.0),\n })\n if err != nil {\n log.Fatal(err)\n }\n if res != nil {\n for {\n // handle items\n\n res, err = res.Next()\n\n if err != nil {\n // handle error\n }\n\n if res == nil {\n break\n }\n }\n }\n}" - lang: ruby label: listCommissions source: |- require 'dub' Models = ::OpenApiSDK::Models s = ::OpenApiSDK::Dub.new( security: Models::Shared::Security.new( token: 'DUB_API_KEY' ) ) req = Models::Operations::ListCommissionsRequest.new( ending_before: 'cm_1KAP4CGN2Z5TPYYQ1W4JEYD56', starting_after: 'cm_1KAP4CGN2Z5TPYYQ1W4JEYD56', page: 1.0, page_size: 50.0 ) res = s.commissions.list(request: req) unless res.nil? # handle response end - lang: typescript label: listCommissions source: |- import { Dub } from "dub"; const dub = new Dub({ token: "DUB_API_KEY", }); async function run() { const result = await dub.commissions.list(); for await (const page of result) { console.log(page); } } run(); components: responses: '400': description: >- The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). content: application/json: schema: x-speakeasy-name-override: BadRequest type: object properties: error: type: object properties: code: type: string enum: - bad_request description: A short code indicating the error code returned. example: bad_request message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#bad-request required: - code - message required: - error '401': description: >- Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response. content: application/json: schema: x-speakeasy-name-override: Unauthorized type: object properties: error: type: object properties: code: type: string enum: - unauthorized description: A short code indicating the error code returned. example: unauthorized message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#unauthorized required: - code - message required: - error '403': description: >- The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server. content: application/json: schema: x-speakeasy-name-override: Forbidden type: object properties: error: type: object properties: code: type: string enum: - forbidden description: A short code indicating the error code returned. example: forbidden message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#forbidden required: - code - message required: - error '404': description: The server cannot find the requested resource. content: application/json: schema: x-speakeasy-name-override: NotFound type: object properties: error: type: object properties: code: type: string enum: - not_found description: A short code indicating the error code returned. example: not_found message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#not-found required: - code - message required: - error '409': description: >- This response is sent when a request conflicts with the current state of the server. content: application/json: schema: x-speakeasy-name-override: Conflict type: object properties: error: type: object properties: code: type: string enum: - conflict description: A short code indicating the error code returned. example: conflict message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#conflict required: - code - message required: - error '410': description: >- This response is sent when the requested content has been permanently deleted from server, with no forwarding address. content: application/json: schema: x-speakeasy-name-override: InviteExpired type: object properties: error: type: object properties: code: type: string enum: - invite_expired description: A short code indicating the error code returned. example: invite_expired message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: https://dub.co/docs/api-reference/errors#invite-expired required: - code - message required: - error '422': description: >- The request was well-formed but was unable to be followed due to semantic errors. content: application/json: schema: x-speakeasy-name-override: UnprocessableEntity type: object properties: error: type: object properties: code: type: string enum: - unprocessable_entity description: A short code indicating the error code returned. example: unprocessable_entity message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://dub.co/docs/api-reference/errors#unprocessable-entity required: - code - message required: - error '429': description: >- The user has sent too many requests in a given amount of time ("rate limiting") content: application/json: schema: x-speakeasy-name-override: RateLimitExceeded type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded description: A short code indicating the error code returned. example: rate_limit_exceeded message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://dub.co/docs/api-reference/errors#rate-limit_exceeded required: - code - message required: - error '500': description: The server has encountered a situation it does not know how to handle. content: application/json: schema: x-speakeasy-name-override: InternalServerError type: object properties: error: type: object properties: code: type: string enum: - internal_server_error description: A short code indicating the error code returned. example: internal_server_error message: x-speakeasy-error-message: true type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://dub.co/docs/api-reference/errors#internal-server_error required: - code - message required: - error securitySchemes: token: type: http description: Default authentication mechanism scheme: bearer x-speakeasy-example: DUB_API_KEY ````