List subscriptions
List subscriptions, optionally narrowed to one customer with `customerId`. A subscription here is a container with a customer and a currency; the money lives in its subscription events, which record every new, upgrade, downgrade, cancel, and reactivate. To see what a subscription is currently worth, read its events rather than the subscription row. Subscriptions with a non-null `externalId` are mirrored from a billing provider and should be changed there, not here.
Authentication
sf_… API key in the bearerAuth field below.A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.
In: header
Path Parameters
1 <= lengthQuery Parameters
uuidResponse Body
application/json
curl -X GET "https://example.com/companies/string/subscriptions"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac", "externalId": "string", "name": "string", "currency": "EUR", "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string" }]Update external id
Replace a product's external ids with the list you send. This is a full replacement, not a merge, so include the ids you want to keep. An id already claimed by a different product in the same company is refused with 409, which stops one billing plan mapping to two products.
Create subscription
Create a subscription for a customer. Creating one on its own contributes nothing to MRR: add subscription events to it, starting with a `new` event, for the revenue to appear. `currency` is fixed at the subscription level, so a customer paying in two currencies needs two subscriptions. Set `externalId` only when mirroring a billing provider; a value already used by another subscription is refused with 409.