SaaSFlow
DevelopersAPIReferencecustomers

List customers

List customers, sorted by name, each enriched with its transaction count, subscription count, and current committed MRR.

Authentication

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

Authorization

Authorization<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.

In: header

Path Parameters

companyId*string
Length1 <= length

Query Parameters

q?string
limit?integer
Range1 <= value <= 500
offset?|
Range0 <= value
onlyActive?string

Value in

  • "0"
  • "1"
  • "true"
  • "false"
linkedTo?string

Keep only rows linked to an integration: an integration name (e.g. stripe, digistore24) keeps rows carrying an external id from that integration, any keeps rows linked to at least one integration, none keeps rows linked to no integration.

Value in

  • "any"
  • "none"
  • "stripe"
  • "slack"
  • "hubspot"
  • "datevPayroll"
  • "finway"
  • "pleo"
  • "salesforce"
  • "digistore24"
  • "paypal"
productId?string

Keep only the customers with a subscription that booked an event against this product, which is what the product page links to for its customers.

Formatuuid

Response Body

application/json

curl -X GET "https://example.com/companies/string/customers"
null