Buttondown Documentation

Buttondown Documentation

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook

Subscriber Stripe subscriptions

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/subscribers/{id_or_email}/stripe-subscriptions"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "results": [
        {
            "subscription_id": "sub_whatever",
            "url": "https://dashboard.stripe.com/subscriptions/sub_whatever",
            "creation_date": "2023-01-01T00:00:00",
            "ending_date": "2023-01-01T00:00:00",
            "amount": 1000,
            "currency": "usd",
            "cadence": "month",
            "status": "active",
            "application_fee_percent": 0.1,
            "source": "substack",
            "product": null
        }
    ],
    "count": 1
}

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook