Skip to main content
GET
/
api
/
v1
/
operations
/
payment
/
plans
curl -X GET "https://app.lance.so/api/v1/operations/payment/plans"

[
  {
    "id": "prod_starter123",
    "productId": "prod_starter123",
    "label": "Starter",
    "price": "€ 29",
    "interval": "month",
    "amount": 500,
    "currency": "€",
    "description": "Perfect for individuals",
    "features": [
      "500 credits per month",
      "Email enrichment",
      "Basic support"
    ]
  },
  {
    "id": "prod_growth456",
    "productId": "prod_growth456",
    "label": "Growth",
    "price": "€ 79",
    "interval": "month",
    "amount": 2000,
    "currency": "€",
    "description": "For growing teams",
    "features": [
      "2000 credits per month",
      "Email & phone enrichment",
      "Priority support",
      "CRM integration"
    ]
  },
  {
    "id": "prod_enterprise789",
    "productId": "prod_enterprise789",
    "label": "Enterprise",
    "price": "€ 199",
    "interval": "month",
    "amount": 10000,
    "currency": "€",
    "description": "For large organizations",
    "features": [
      "10000 credits per month",
      "All enrichment features",
      "Dedicated support",
      "Custom integrations"
    ]
  }
]
This endpoint returns a list of all available credit subscription plans that can be purchased. Plans are fetched directly from Stripe and include pricing, features, and credit amounts.

​
Authentication

This endpoint is publicly accessible and does not require authentication. It returns the same plan information to all users.

​
Request

This endpoint does not require any request parameters.

​
Response

The response is an array of subscription plan objects, sorted by credit amount in ascending order (lowest to highest).
​
response
array
required
The response body is a JSON array of subscription plan objects (not wrapped in an object).

​
Plan Configuration

Plans are configured in Stripe with the following requirements:
Stripe FieldRequirement
metadata.typeMust be set to credits to be included in results
metadata.creditsNumber of credits included in the plan
default_priceActive price for the product
marketing_featuresOptional list of features to display

​
Supported Currencies

Currency CodeSymbol
EUR€
USD$
GBP£
CHFCHF
curl -X GET "https://app.lance.so/api/v1/operations/payment/plans"

[
  {
    "id": "prod_starter123",
    "productId": "prod_starter123",
    "label": "Starter",
    "price": "€ 29",
    "interval": "month",
    "amount": 500,
    "currency": "€",
    "description": "Perfect for individuals",
    "features": [
      "500 credits per month",
      "Email enrichment",
      "Basic support"
    ]
  },
  {
    "id": "prod_growth456",
    "productId": "prod_growth456",
    "label": "Growth",
    "price": "€ 79",
    "interval": "month",
    "amount": 2000,
    "currency": "€",
    "description": "For growing teams",
    "features": [
      "2000 credits per month",
      "Email & phone enrichment",
      "Priority support",
      "CRM integration"
    ]
  },
  {
    "id": "prod_enterprise789",
    "productId": "prod_enterprise789",
    "label": "Enterprise",
    "price": "€ 199",
    "interval": "month",
    "amount": 10000,
    "currency": "€",
    "description": "For large organizations",
    "features": [
      "10000 credits per month",
      "All enrichment features",
      "Dedicated support",
      "Custom integrations"
    ]
  }
]

​
Error Codes

Status CodeError CodeDescription
500INTERNAL_ERRORServer error while fetching plans from Stripe

​
Notes

  • Plans are fetched in real-time from Stripe, ensuring pricing is always current
  • Only active products with metadata.type = "credits" are returned
  • Plans are automatically sorted by credit amount (lowest to highest)
  • If a product has no active price, an error will be thrown
  • The response is an empty array if no credit products are configured in Stripe