Skip to Content
SaaSFlow
DevelopersAPIReferencesubscriptions

List subscriptions

List subscriptions, optionally narrowed to one customer with customerId or to the subscriptions that ever booked an event against a product with productId.

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/subscriptions

Authorization

headerAuthorization<token>

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.

Path Parameters

companyId*string
Formatuuid

Query Parameters

customerId?string
Formatuuid
productId?string
Formatuuid

Response Body

List of subscriptions

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/subscriptions'
Example Response200
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",    "externalId": "string",    "name": "string",    "currency": "EUR",    "replacedBySubscriptionId": "91638c4c-42cb-4ba3-a36c-8035f4ae68e4",    "createdTime": "2019-08-24T14:15:22Z",    "createdUserId": "string",    "lastUpdatedTime": "2019-08-24T14:15:22Z",    "lastUpdatedUserId": "string",    "customerName": "string"  }]