Skip to main content
POST
/
v2
/
api
/
crm
/
people
/
search
Search people
curl --request POST \
  --url https://api.withallo.com/v2/api/crm/people/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "job_title": "engineer",
    "company": "Acme"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}
'
{
  "data": [
    {
      "id": "per-abc123",
      "name": "John",
      "last_name": "Doe",
      "job_title": "CEO",
      "website": "https://example.com",
      "address": "123 Main St",
      "numbers": [
        "+33612345678"
      ],
      "emails": [
        "[email protected]"
      ],
      "company": {
        "id": "com-xyz789",
        "name": "Acme Corp"
      },
      "interactions": 5,
      "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)
searchstringFull-text keyword search across person fields
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": {
    "job_title": "engineer",
    "company": "Acme"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}

Available filter fields

FieldMatch typeDescription
namecontainsFirst name
last_namecontainsLast name
job_titlecontainsJob title
websitecontainsWebsite URL
companycontainsCompany name
phone_numberexactPhone number
emailcontainsEmail address
deal_statusexactDeal status

Authorizations

Authorization
string
header
required

Body

application/json

Request body for searching people

filters
object

Named filters. All are combined with AND.

search
string | null

Free-text search across name, email, phone number, and company

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