Retrieve category
Retrieve a single category by id. Returns 404 if the category 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*stringuuidcategoryId*stringuuidCategory details
application/json- response
id*stringuuidcompanyId*stringuuidname*stringThe name of the category.
emoji*|An emoji representing the category.
plTypes*array<>The P&L types that the category can be used for.
system*booleanFlag indicating if this is a system-defined category.
systemKey*|Semantic key for system categories (e.g., revRecurring, paymentFees).
order*numberA number used for ordering categories in the UI.
-8388608 <= value <= 8388607createdTime*|date-timecreatedUserId*string|nulllastUpdatedTime*|date-timelastUpdatedUserId*string|nullcurl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/categories/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "name": "string", "emoji": "string", "plTypes": [ "revenue" ], "system": true, "systemKey": "string", "order": -8388608, "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string"}Reorder
Set the display order of categories. Each id's order becomes its position in the array you send, so send the full list rather than the few you moved.
Delete category
Delete a category. Refused with 409 while any transaction is still categorized under it or any planned transaction still uses it, and with 400 for system…