Skip to main content

Universal Search

POST 
/search

Free-text search by name or address across the accounts, calendar events, teams, and users visible to the authenticated user, plus address suggestions for locations. Use scopes to limit the entity types searched; when omitted, all scopes except Location are searched. Company results are only returned to Terros staff. Pass bias to prefer address suggestions near a coordinate. Results are short summaries, capped at 40 per request (plus any location results). Their identifiers are accountId, eventId, companyId, teamId, userId, or, when type is Location, placeId; follow up with /account/get or the corresponding endpoint for full details. For a Location result, placeId is either a supported Terros location ID (TLoc., FA., LocNew., Can., or PR.) or an external address autocomplete identifier. Exchange an external identifier for structured address details and a matched Terros location ID before using it with endpoints that require locationId. Legacy Loc: values pass schema validation, but the current location reader does not resolve them and returns NotFound. Use /account/list instead for structured account filters and pagination, and /user/search or /user/list for user-specific filters.

Request​

Responses​

Success