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

Retrieve a rate card version v2

Retrieve a specific version of a RateCard object.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    The ID of the version to retrieve.

  • rate_card_idstringRequired

    The ID of the RateCard object.

Returns

Response attributes

  • idstring

    The ID of the RateCardVersion.

  • objectstring, value is "v2.billing.rate_card_version"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • createdtimestamp

    Timestamp of when the object was created.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • rate_card_idstring

    The ID of the RateCard that this version belongs to.

Error Codes
404rate_card_not_found

Returned when the provided rate_card ID cannot be found.

404rate_card_version_not_found

Returned when the provided rate_card_version ID cannot be found.

GET /v2/billing/rate_cards/:id/versions/:id
curl https://api.stripe.com/v2/billing/rate_cards/rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG/versions/rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "id": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
  "object": "v2.billing.rate_card.version",
  "rate_card_id": "rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG",
  "created": "2024-11-26T16:33:03.000Z",
  "livemode": false
}

List rate card rates v2

List all Rates associated with a RateCard for a specific version (defaults to latest). Rates remain active for all subsequent versions until a new Rate is created for the same MeteredItem.

Learn more about calling API v2 endpoints.

Parameters

  • rate_card_idstringRequired

    The ID of the RateCard to retrieve rates for.

  • limitinteger

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

  • metered_itemstring

    Optionally filter by a MeteredItem.

  • pagestring

    Opaque page token.

  • rate_card_versionstring

    Optionally filter by a RateCard version. If not specified, defaults to the latest version.

Returns

Response attributes

  • dataarray of objects

    The retrieved RateCard rates.

  • next_page_urlnullable string

    The URL of the next page of results, if there is one.

  • previous_page_urlnullable string

    The URL of the previous page of results, if there is one.

GET /v2/billing/rate_cards/:id/rates
curl https://api.stripe.com/v2/billing/rate_cards/rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG/rates \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "data": [
    {
      "id": "rcdr_test_61Rc0EwMrmxaJaSum16RM8VQESSQ4t1K5KYFAmKUSPLs",
      "object": "v2.billing.rate_card.rate",
      "metered_item": {
        "id": "blbli_test_61Rc0Ew1oiQyokWns16RM8VQESSQ4t1K5KYFAmKUSA5o",
        "object": "v2.billing.metered_item",
        "display_name": "API requests",
        "lookup_key": "api_requests",
        "unit_label": "Price per 100 requests",
        "meter": "mtr_test_61RCjiqdTDC91zgip41IqPCzPnxqqSVc",
        "created": "2024-11-26T16:33:03.000Z",
        "livemode": false
      },
      "metadata": {},
      "rate_card": "rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG",
      "rate_card_version": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
      "tiers": [],
      "unit_amount": "1000.0",
      "created": "2024-11-26T16:33:03.000Z",
      "livemode": false
    }
  ]
}

List rate cards v2

List all RateCard objects.

Learn more about calling API v2 endpoints.

Parameters

  • activeboolean

    Optionally filter to active/inactive RateCards.

  • limitinteger

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

  • pagestring

    Opaque page token.

Returns

Response attributes

  • dataarray of objects

    The retrieved RateCards.

  • next_page_urlnullable string

    The URL of the next page of results, if there is one.

  • previous_page_urlnullable string

    The URL of the previous page of results, if there is one.

GET /v2/billing/rate_cards
cURL
curl https://api.stripe.com/v2/billing/rate_cards \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "data": [
    {
      "id": "rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG",
      "object": "v2.billing.rate_card",
      "active": true,
      "currency": "usd",
      "display_name": "My Rate Card",
      "latest_version": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
      "live_version": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
      "metadata": {},
      "service_interval": "month",
      "service_interval_count": 2,
      "tax_behavior": "exclusive",
      "created": "2024-11-26T16:33:03.000Z",
      "livemode": true
    }
  ]
}

List rate card versions v2

List the versions of a RateCard object. Results are sorted in reverse chronological order (most recent first).

Learn more about calling API v2 endpoints.

Parameters

  • rate_card_idstringRequired

    The ID of the RateCard to retrieve versions for.

  • limitinteger

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

  • pagestring

    Opaque page token.

Returns

Response attributes

  • dataarray of objects

    The retrieved RateCard versions.

  • next_page_urlnullable string

    The URL of the next page of results, if there is one.

  • previous_page_urlnullable string

    The URL of the previous page of results, if there is one.

Error Codes
404rate_card_not_found

Returned when the provided rate_card ID cannot be found.

GET /v2/billing/rate_cards/:id/versions
curl https://api.stripe.com/v2/billing/rate_cards/rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG/versions \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "data": [
    {
      "id": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
      "object": "v2.billing.rate_card.version",
      "rate_card_id": "rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG",
      "created": "2024-11-26T16:33:03.000Z",
      "livemode": false
    }
  ]
}

Delete a rate card rate v2

Remove an existing Rate from a RateCard. This will create a new RateCard version without that rate.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    The ID of the rate to remove.

  • rate_card_idstringRequired

    The ID of the RateCard.

Returns

Response attributes

  • idstring

    The ID of the rate that was removed.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

Error Codes
400rate_card_inactive_error

Returned when a user tries to modify a rate or subscription for an inactive rate card.

400rate_card_rate_delete_inactive

Returned when a user tries to remove a rate that is not available in the latest rate card version.

404rate_card_not_found

Returned when the provided rate_card ID cannot be found.

404rate_card_rate_not_found

Returned when the provided rate card rate ID cannot be found.

DELETE /v2/billing/rate_cards/:id/rates/:id
cURL
curl -X DELETE https://api.stripe.com/v2/billing/rate_cards/rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG/rates/rcdr_test_61Rc0EwMrmxaJaSum16RM8VQESSQ4t1K5KYFAmKUSPLs \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"
Response
{
  "id": "rcdr_test_61Rc0EwMrmxaJaSum16RM8VQESSQ4t1K5KYFAmKUSPLs",
  "object": "v2.billing.rate_card.rate"
}