# List pricing splits

Returns the pricing splits your business has declared, sorted by creation date with the most recent split first. Pass `price_id` to return only the splits declared against one dynamic pricing rule.

Endpoint: GET /prices/dynamic-splits
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Query parameters:

  - `price_id` (string)
    Return only the splits declared against this dynamic pricing rule.

  - `per_page` (integer)
    Number of resources per page. Should be between 1 and 100.

  - `page` (integer)
    Page number for pagination. Starts from 1. Get the next page number from the `next` field in the response.

## Response 200:

  - `200` (unknown)
    List of pricing splits matching the filters

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    The unique identifier for the pricing split.
    Example: psplit_7Kq2mXbTdLp9

  - `data.price_id` (string)
    The unique identifier of the dynamic pricing rule this split was declared against. See [List dynamic pricing rules](#tag/pricing_split).
    Example: price_5JU9yv0lGSUP

  - `data.bps` (integer | null)
    Your share of the fee in basis points, where 100 bps is 1%. Present when the split was declared with `bps` and `null` otherwise.
    Example: 150

  - `data.fixed_amount` (integer | null)
    Your share of the fee in minor units of `fee_currency`. Present when the split was declared with `fixed_amount` and `null` otherwise.
    Example: 200

  - `data.min_fee` (integer | null)
    The floor you declared for your share, in minor units of `fee_currency`. `null` when you declared no floor.
    Example: 100

  - `data.max_fee` (integer | null)
    The cap you declared for your share, in minor units of `fee_currency`. `null` when you declared no cap.
    Example: 1000

  - `data.fee_currency` (string | null)
    The currency of `fixed_amount`, `min_fee` and `max_fee`, in ISO 4217 format.
    Example: USD

  - `data.created_at` (string)
    Timestamp representing when the pricing split was created.
    Example: 2026-08-01T09:12:44Z

  - `data.updated_at` (string)
    Timestamp representing when the pricing split was last updated.
    Example: 2026-08-01T09:12:44Z

  - `page_meta` (object)

  - `page_meta.current` (integer)
    The current page number.
    Example: 2

  - `page_meta.previous` (integer | null)
    The previous page number.
    Example: 1

  - `page_meta.next` (integer | null)
    The next page number.
    Example: 3

  - `page_meta.per_page` (integer)
    The number of items per page.
    Example: 20

  - `page_meta.pages` (integer)
    The total number of pages.
    Example: 10

  - `page_meta.count` (integer)
    The total number of items.
    Example: 200

## Response 400:

  - `400` (unknown)
    Bad Request — invalid pagination parameters

## Response 400 fields (application/json):

  - `error` (string)
    Enum: "Bad Request"

  - `message` (string)
    Error message.
    Example: per_page must be an integer

## Response 401:

  - `401` (unknown)
    Unauthorized — invalid or missing authentication token

## Response 401 fields (application/json):

  - `error` (string)
    Example: Unauthorized

  - `message` (string)
    Example: Invalid or missing authentication token