Skip to main content
POST
/
v2
/
api
/
crm
/
companies
/
search
Search companies
curl --request POST \
  --url https://api.withallo.com/v2/api/crm/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "name": "Acme",
    "industry": "Technology"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
'
{
  "data": [
    {
      "id": "com-xyz789",
      "name": "Acme Corp",
      "website": "https://acme.com",
      "industry": "Technology",
      "person_count": 3,
      "interactions": 12,
      "last_activity_at": "2026-04-28T10:30:00",
      "created_at": "2026-04-01T09:00:00",
      "updated_at": "2026-04-28T10:30:00"
    }
  ],
  "pagination": {
    "page": 123,
    "size": 123,
    "total_count": 123,
    "total_pages": 123,
    "has_more": true
  }
}

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.

Required scope: CRM_READ
This endpoint is paginated. Use page and size in the request body to control results. See Pagination.

Request body

FieldTypeDescription
filtersobjectNamed filters (see below)
sortstringSort order: DATE_DESC, DATE_ASC, NAME_ASC, NAME_DESC, CREATED_DESC, CREATED_ASC
pageintegerPage number (1-indexed)
sizeintegerResults per page (max 100)

Filters

Pass an object with named fields. All provided filters are combined with AND.
{
  "filters": {
    "name": "Acme",
    "industry": "Technology"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}

Available filter fields

FieldMatch typeDescription
namecontainsCompany name
websitecontainsWebsite URL
industrycontainsIndustry sector

Authorizations

Authorization
string
header
required

Body

application/json

Request body for searching companies

filters
object

Named filters. All are combined with AND.

sort
enum<string> | null

Sort order (default: DATE_DESC)

Available options:
DATE_DESC,
DATE_ASC,
NAME_ASC,
NAME_DESC,
CREATED_DESC,
CREATED_ASC
page
integer
default:1

Page number (1-indexed)

size
integer
default:20

Results per page

Required range: x <= 100

Response

Search results

data
object[]
pagination
object