List legacy subscription plans (internal) Deprecated

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

Close
GET /payments/plans

Legacy subscription model, replaced by GET /billing/plans and GET /billing/plan/current. Lists the legacy Stripe plans with prices and which one is current, plus the attached payment method, the upcoming invoice (null without a subscription) and billingAlert (null when billing is healthy, otherwise the past-due and blocked state). Requires an org admin, owner or billing role.

Headers

  • organization string Required

    id of the selected (active) organization

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • data array[object] Required
        Hide data attributes Show data attributes object
        • id string Required
        • active boolean Required
        • attributes array[string] Required
        • created number Required
        • default_price object Required
          Hide default_price attributes Show default_price attributes object
          • id string Required
          • active boolean Required
          • billing_scheme string Required
          • created number Required
          • currency string Required
          • custom_unit_amount object | null Required
          • livemode boolean Required
          • lookup_key string Required
          • metadata object Required
          • type string Required
          • unit_amount number Required
          • unit_amount_decimal string Required
        • features array[object] Required
          Hide features attribute Show features attribute object
          • name string
        • livemode boolean Required
        • metadata object Required
        • name string Required
        • tax_code object | null Required
        • unit_label object | null Required
        • url object | null Required
        • isPayAsYouGo boolean Required
        • isCurrentPlan boolean Required
      • attachedPaymentMethod object Required

        Attached payment method

      • upcomingInvoice object Required

        Attached payment method

        Hide upcomingInvoice attributes Show upcomingInvoice attributes object
        • account_country string Required
        • account_name string Required
        • amount_due number Required
        • amount_paid number Required
        • amount_remaining number Required
        • attempted boolean Required
        • billing_reason string Required
        • collection_method string Required
        • created number Required
        • currency string Required
        • customer_address object | null Required
        • customer_email string Required
        • customer_name string Required
        • customer_phone string | null Required
        • description string | null Required
        • discount object | null Required
        • discounts array[string] Required
        • due_date object | null Required
        • livemode boolean Required
        • period_end number Required
        • period_start number Required
        • status string Required
        • subtotal number Required
        • subtotal_excluding_tax number Required
        • tax number Required
        • total number Required
        • total_discount_amounts array[object] Required
        • total_excluding_tax number Required
        • total_tax_amounts array[object] Required
        • lines array[object] Required
          Hide lines attributes Show lines attributes object
          • id string Required
          • amount number Required
          • amount_excluding_tax number Required
          • currency string Required
          • description string Required
          • discount_amounts array[object] Required
          • discountable boolean Required
          • discounts array[string] Required
          • livemode boolean Required
          • metadata object Required
          • period object Required
          • product_lookup_description string Required
          • plan object Required
            Hide plan attributes Show plan attributes object
            • id string Required
            • active boolean Required
            • attributes array[string] Required
            • created number Required
            • default_price object Required
              Hide default_price attributes Show default_price attributes object
              • id string Required
              • active boolean Required
              • billing_scheme string Required
              • created number Required
              • currency string Required
              • custom_unit_amount object | null Required
              • livemode boolean Required
              • lookup_key string Required
              • metadata object Required
              • type string Required
              • unit_amount number Required
              • unit_amount_decimal string Required
            • features array[object] Required
              Hide features attribute Show features attribute object
              • name string
            • livemode boolean Required
            • metadata object Required
            • name string Required
            • tax_code object | null Required
            • unit_label object | null Required
            • url object | null Required
            • isPayAsYouGo boolean Required
            • isCurrentPlan boolean Required
          • price object Required
            Hide price attributes Show price attributes object
            • id string Required
            • active boolean Required
            • billing_scheme string Required
            • created number Required
            • currency string Required
            • custom_unit_amount object | null Required
            • livemode boolean Required
            • lookup_key string Required
            • metadata object Required
            • type string Required
            • unit_amount number Required
            • unit_amount_decimal string Required
          • quantity number Required
          • unit_amount_excluding_tax number Required
      • currentPlan object Required
        Hide currentPlan attributes Show currentPlan attributes object
        • id string Required
        • active boolean Required
        • attributes array[string] Required
        • created number Required
        • default_price object Required
          Hide default_price attributes Show default_price attributes object
          • id string Required
          • active boolean Required
          • billing_scheme string Required
          • created number Required
          • currency string Required
          • custom_unit_amount object | null Required
          • livemode boolean Required
          • lookup_key string Required
          • metadata object Required
          • type string Required
          • unit_amount number Required
          • unit_amount_decimal string Required
        • features array[object] Required
          Hide features attribute Show features attribute object
          • name string
        • livemode boolean Required
        • metadata object Required
        • name string Required
        • tax_code object | null Required
        • unit_label object | null Required
        • url object | null Required
        • isPayAsYouGo boolean Required
        • isCurrentPlan boolean Required
      • billingAlert object Required

        Dunning banner state; null when billing is healthy

        Hide billingAlert attributes Show billingAlert attributes object
        • pastDue boolean Required

          Subscription is past due (in dunning)

        • graceUntil string(date-time) | null Required

          End of the grace window while past due

        • blocked boolean Required

          Access is blocked (grace expired, or subscription unpaid/canceled)

    • statusCode number Required
    • timestamp string(date-time) Required
GET /payments/plans
curl \
 --request GET 'http://api.example.com/payments/plans' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200)
{
  "data": {
    "data": [
      {
        "id": "prod_Example",
        "active": true,
        "attributes": [
          "string"
        ],
        "created": 1736935500,
        "default_price": {
          "id": "price_1PExample",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1736935500,
          "currency": "usd",
          "custom_unit_amount": {},
          "livemode": false,
          "lookup_key": "firm_monthly",
          "metadata": {},
          "type": "recurring",
          "unit_amount": 24900,
          "unit_amount_decimal": "24900"
        },
        "features": [
          {
            "name": "Unlimited seats"
          }
        ],
        "livemode": false,
        "metadata": {
          "plan": "firm"
        },
        "name": "Firm",
        "tax_code": {},
        "unit_label": {},
        "url": {},
        "isPayAsYouGo": false,
        "isCurrentPlan": true
      }
    ],
    "attachedPaymentMethod": {
      "id": "pm_1PExample",
      "type": "card",
      "card": {
        "brand": "visa",
        "last4": "4242",
        "exp_month": 4,
        "exp_year": 2030
      }
    },
    "upcomingInvoice": {
      "account_country": "US",
      "account_name": "Acme Legal",
      "amount_due": 24900,
      "amount_paid": 0,
      "amount_remaining": 24900,
      "attempted": false,
      "billing_reason": "upcoming",
      "collection_method": "charge_automatically",
      "created": 1736935500,
      "currency": "usd",
      "customer_address": {},
      "customer_email": "billing@example.com",
      "customer_name": "Acme Legal",
      "customer_phone": "string",
      "description": "string",
      "discount": {},
      "discounts": [
        "string"
      ],
      "due_date": {},
      "livemode": false,
      "period_end": 1739613900,
      "period_start": 1736935500,
      "status": "draft",
      "subtotal": 24900,
      "subtotal_excluding_tax": 24900,
      "tax": 0,
      "total": 24900,
      "total_discount_amounts": [
        {}
      ],
      "total_excluding_tax": 24900,
      "total_tax_amounts": [
        {}
      ],
      "lines": [
        {
          "id": "il_1PExample",
          "amount": 24900,
          "amount_excluding_tax": 24900,
          "currency": "usd",
          "description": "1 x Firm (at $249.00 / month)",
          "discount_amounts": [
            {}
          ],
          "discountable": true,
          "discounts": [
            "string"
          ],
          "livemode": false,
          "metadata": {},
          "period": {
            "start": 1736935500,
            "end": 1739613900
          },
          "product_lookup_description": "Subscription",
          "plan": {
            "id": "prod_Example",
            "active": true,
            "attributes": [
              "string"
            ],
            "created": 1736935500,
            "default_price": {
              "id": "price_1PExample",
              "active": true,
              "billing_scheme": "per_unit",
              "created": 1736935500,
              "currency": "usd",
              "custom_unit_amount": {},
              "livemode": false,
              "lookup_key": "firm_monthly",
              "metadata": {},
              "type": "recurring",
              "unit_amount": 24900,
              "unit_amount_decimal": "24900"
            },
            "features": [
              {
                "name": "Unlimited seats"
              }
            ],
            "livemode": false,
            "metadata": {
              "plan": "firm"
            },
            "name": "Firm",
            "tax_code": {},
            "unit_label": {},
            "url": {},
            "isPayAsYouGo": false,
            "isCurrentPlan": true
          },
          "price": {
            "id": "price_1PExample",
            "active": true,
            "billing_scheme": "per_unit",
            "created": 1736935500,
            "currency": "usd",
            "custom_unit_amount": {},
            "livemode": false,
            "lookup_key": "firm_monthly",
            "metadata": {},
            "type": "recurring",
            "unit_amount": 24900,
            "unit_amount_decimal": "24900"
          },
          "quantity": 1,
          "unit_amount_excluding_tax": 24900
        }
      ]
    },
    "currentPlan": {
      "id": "prod_Example",
      "active": true,
      "attributes": [
        "string"
      ],
      "created": 1736935500,
      "default_price": {
        "id": "price_1PExample",
        "active": true,
        "billing_scheme": "per_unit",
        "created": 1736935500,
        "currency": "usd",
        "custom_unit_amount": {},
        "livemode": false,
        "lookup_key": "firm_monthly",
        "metadata": {},
        "type": "recurring",
        "unit_amount": 24900,
        "unit_amount_decimal": "24900"
      },
      "features": [
        {
          "name": "Unlimited seats"
        }
      ],
      "livemode": false,
      "metadata": {
        "plan": "firm"
      },
      "name": "Firm",
      "tax_code": {},
      "unit_label": {},
      "url": {},
      "isPayAsYouGo": false,
      "isCurrentPlan": true
    },
    "billingAlert": {
      "pastDue": true,
      "graceUntil": "2026-01-22T10:15:00.000Z",
      "blocked": false
    }
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}