Billing

List all billing plans

Changed on

Returns a list of all billing plans for the instance. The plans are returned sorted by creation date, with the newest plans appearing first. This includes both free and paid plans. Pagination is supported.

get/billing/plans

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/billing/plans
  • Auth: HTTP bearer

Query parameters

paginatedboolean

Whether to paginate the results. If true, the results will be paginated. If false, the results will not be paginated.

limitinteger

Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

offsetinteger

Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

payer_type'user' | 'org'

Filter plans by payer type

Response

A list of commerce plans.

total_countinteger required

Total number of plans.

Changes

  • 2025-11-10b1a5498e4465Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the // response's property type changed from object to no type for status

    • breaking

      removed the required property /// from the response with the status

    • breaking

      removed the required property /// from the response with the status

    • breaking

      removed the required property /// from the response with the status

    • breaking

      removed the required property /// from the response with the status

    • info

      added to the // response property allOf list for the response status

  • 2025-11-1042e3e85e75f8Revision changes
    • info

      added the optional property // to the response with the status