Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

List Custom Pricing Units v2

List all Custom Pricing Unit objects.

Learn more about calling API v2 endpoints.

Parameters

  • activeboolean

    Filter for active/inactive custom pricing units. Mutually exclusive with lookup_keys.

  • limitinteger

    Optionally set the maximum number of results per page. Defaults to 20.

  • lookup_keysarray of strings

    Filter by lookup keys. Mutually exclusive with active. You can specify up to 10 lookup keys.

  • pagestring

    A cursor for use in pagination.

Returns

Response attributes

  • dataarray of objects

    List of Custom Pricing Units.

  • next_page_urlnullable string

    The URL to get the next page of results, if there are any.

  • previous_page_urlnullable string

    The URL to get the previous page of results, if there are any.

GET /v2/billing/custom_pricing_units
curl https://api.stripe.com/v2/billing/custom_pricing_units \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-08-27.preview"
Response
{
  "data": [
    {
      "active": true,
      "created": "2025-01-01T00:00:00.000Z",
      "display_name": "Unit #1",
      "id": "cpu_61T4sQA90ELFdWUhl16Ss95I3tSQSib3S1PC0IDCSFCS",
      "lookup_key": "my-custom-pricing-unit-1",
      "metadata": {},
      "object": "v2.billing.custom_pricing_unit",
      "livemode": true
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Licensed Items v2

A Licensed Item represents any item that you bill customers for based on the subscribed quantity.

Learn more about calling API v2 endpoints.
Endpoints

Service Actions v2

A Service Action represents a recurring, automated action that can be applied as part of a subscription.

Learn more about calling API v2 endpoints.
Endpoints

Rate Cards v2

A Rate Card describes usage-based pricing. To bill a customer using a Rate Card, create a Rate Card Subscription which links it to the corresponding Billing Cadence.

Learn more about calling API v2 endpoints.
Endpoints

Rate Card Subscriptions v2

A Rate Card Subscription links a Rate Card to a specific Billing Cadence. While the rate card subscription is active, Stripe will bill the payer according to the rate card’s pricing.

Learn more about calling API v2 endpoints.
Endpoints