Search companies with advanced filtering
POST/v2/companies/search
Performs advanced company search with multiple filtering criteria, sorting options, and pagination. Supports complex queries across company attributes, business information, and organizational metadata.
Search Capabilities:
- Multi-field filtering (name, tax number, email, dates, etc.)
- Flexible date range searches for creation and modification dates
- Multiple value matching (OR logic within fields)
- Custom sorting by any company field
- Pagination with configurable page sizes
- Source system filtering and organizational hierarchy searches
Performance Features:
- Optimized database queries with proper indexing
- Configurable result limits to prevent large responses
- Efficient pagination for large datasets
- Cached results for frequently accessed data
- Support for complex organizational queries
Use Cases:
- Company discovery and business intelligence
- Data analysis and reporting across organizations
- Integration with external business systems
- Company service lookup tools
- Organizational structure analysis and management
- Compliance and audit reporting
Request
Responses
- 200
- 400
- 401
- 403
Search completed successfully with paginated results
Invalid search criteria or validation errors
Authentication required - provide valid OAuth2 token
Insufficient permissions - requires companies:read scope