SaaSFlow
DevelopersAPIReferencesearch

List search

Free-text search across a company, grouped by entity type. Use it when you know a name but not an id: one call matches customers, vendors, and accounts on name, and transactions on counterparty or description. This backs the command palette, so each category returns at most 5 hits. Categories the caller has no read permission for come back empty rather than 403, which keeps the search box usable on partial-permission grants. When you need a full, filtered, paginated list of one entity type, use that resource's own endpoint.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
GET
/companies/{companyId}/search

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
Length1 <= length

Response Body

application/json

curl -X GET "https://example.com/companies/string/search?q=string"
{  "customers": [    {      "type": "customer",      "id": "string",      "name": "string",      "logo": true    }  ],  "vendors": [    {      "type": "vendor",      "id": "string",      "name": "string",      "logo": true    }  ],  "accounts": [    {      "type": "account",      "id": "string",      "name": "string",      "accountType": "bank"    }  ],  "transactions": [    {      "type": "transaction",      "id": "string",      "fromTo": "string",      "description": "string",      "date": "string",      "amountValue": 0,      "amountCurrency": "string",      "accountId": "string",      "accountName": "string"    }  ]}