Retrieve customer
Retrieve a single customer by id. Returns 404 if the customer does not exist or belongs to another company.
Authentication
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.
companyId*stringuuidcustomerId*stringuuidCustomer details
application/json- response
id*stringuuidcompanyId*stringuuidname*stringThe name of the customer.
nameManuallyEdited*booleanWhether the name is protected from integration updates after a manual rename.
defaultCategorization*|The default categorization to apply to transactions from this customer.
domains*array<string>An array of website domains associated with this customer.
logo*booleanFlag indicating if a logo is available for this customer.
autoCreatedSource*|The source from which this customer was automatically created.
"searchApiGoogleWebSearch""stripe""hubspot""datevPayroll""finway""pleo""digistore24""paypal"nullcountryCode*|ISO 3166-1 alpha-2 country code (e.g., US, DE, GB).
createdTime*|date-timecreatedUserId*string|nulllastUpdatedTime*|date-timelastUpdatedUserId*string|nullexternalIds*array<string>External IDs (URNs) linked to this customer (e.g., Stripe, HubSpot).
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "name": "string", "nameManuallyEdited": true, "defaultCategorization": { "categoryId": "string", "usingDateRule": { "type": "transactionDate" }, "plSplit": { "revenue": 0, "cogs": 0, "cac": 0, "pd": 0, "ga": 0, "no": 0, "neutral": 0 }, "passThroughTax": 0, "transferTargetAccountId": "string" }, "domains": [ "string" ], "logo": true, "autoCreatedSource": "searchApiGoogleWebSearch", "countryCode": "string", "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string", "externalIds": [ "string" ]}Linked systems
The integrations at least one customer is linked to, as the values the list endpoint accepts for linkedTo (e.g. ["digistore24", "stripe"]). Empty when no…
Delete customer
Delete a customer. This reaches further than it looks: their subscriptions are cascade-deleted, which changes MRR history, and any planned transaction…