> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Search companies > Search and filter companies in your CRM. **Required scope:** `CRM_READ` This endpoint is paginated. Use `page` and `size` in the request body to control results. See [Pagination](/en/v2/api-reference/guides/pagination). ## Request body | Field | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------- | | `filters` | object | Named filters (see below) | | `sort` | string | Sort order: `DATE_DESC`, `DATE_ASC`, `NAME_ASC`, `NAME_DESC`, `CREATED_DESC`, `CREATED_ASC` | | `page` | integer | Page number (1-indexed) | | `size` | integer | Results per page (max 100) | ## Filters Pass an object with named fields. All provided filters are combined with AND. ```json theme={null} { "filters": { "name": "Acme", "industry": "Technology" }, "sort": "NAME_ASC", "page": 1, "size": 20 } ``` ### Available filter fields | Field | Match type | Description | | ---------- | ---------- | --------------- | | `name` | contains | Company name | | `website` | contains | Website URL | | `industry` | contains | Industry sector | ## OpenAPI ````yaml POST /v2/api/crm/companies/search openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. paths: /v2/api/crm/companies/search: post: tags: - CRM summary: Search companies description: Search and filter companies in your CRM. operationId: searchCompanies requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SearchCompaniesRequest' example: filters: name: Acme industry: Technology sort: NAME_ASC page: 1 size: 20 responses: '200': description: Search results content: application/json: schema: allOf: - type: object properties: data: type: array items: $ref: '#/components/schemas/CrmCompany' - $ref: '#/components/schemas/PaginatedResponse' '401': $ref: '#/components/responses/ApiUnauthorized' '422': $ref: '#/components/responses/ApiValidationError' '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: schemas: SearchCompaniesRequest: type: object description: Request body for searching companies properties: filters: type: object nullable: true description: Named filters. All are combined with AND. properties: name: type: string description: Filter by company name (contains) website: type: string description: Filter by website (contains) industry: type: string description: Filter by industry (contains) sort: type: string nullable: true enum: - DATE_DESC - DATE_ASC - NAME_ASC - NAME_DESC - CREATED_DESC - CREATED_ASC description: 'Sort order (default: DATE_DESC)' page: type: integer default: 1 description: Page number (1-indexed) size: type: integer default: 20 maximum: 100 description: Results per page CrmCompany: type: object description: A company in the CRM properties: id: type: string description: Unique company identifier example: com-xyz789 name: type: string description: Company name example: Acme Corp website: type: string nullable: true description: Company website URL example: https://acme.com industry: type: string nullable: true description: Industry sector example: Technology person_count: type: integer description: Number of people linked to this company example: 3 interactions: type: integer description: Total number of interactions across all people in this company example: 12 last_activity_at: type: string format: date-time nullable: true description: Timestamp of the last activity example: '2026-04-28T10:30:00' created_at: type: string format: date-time description: When the company was created example: '2026-04-01T09:00:00' updated_at: type: string format: date-time description: When the company was last updated example: '2026-04-28T10:30:00' PaginatedResponse: type: object properties: pagination: $ref: '#/components/schemas/Pagination' Pagination: type: object properties: page: type: integer size: type: integer total_count: type: integer total_pages: type: integer has_more: type: boolean ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiValidationError: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ````