Passer au contenu principal
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.

Scope requis : CRM_READ
Cet endpoint est pagine. Utilisez page et size dans le corps de la requete pour controler les resultats. Voir Pagination.

Corps de la requete

ChampTypeDescription
filtersobjectFiltres nommes (voir ci-dessous)
searchstringRecherche en texte integral sur les champs de la personne
sortstringOrdre de tri : DATE_DESC, DATE_ASC, NAME_ASC, NAME_DESC, CREATED_DESC, CREATED_ASC
pageintegerNumero de page (commence a 1)
sizeintegerResultats par page (max 100)

Filtres

Passez un objet avec des champs nommes. Tous les filtres fournis sont combines avec AND.
{
  "filters": {
    "job_title": "engineer",
    "company": "Acme"
  },
  "sort": "NAME_ASC",
  "page": 1,
  "size": 20
}

Champs de filtre disponibles

ChampType de correspondanceDescription
namecontientPrenom
last_namecontientNom de famille
job_titlecontientTitre du poste
websitecontientURL du site web
companycontientNom de l’entreprise
phone_numberexactNumero de telephone
emailcontientAdresse e-mail
deal_statusexactStatut du deal

Autorisations

Authorization
string
header
requis

Corps

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)

Options disponibles:
DATE_DESC,
DATE_ASC,
NAME_ASC,
NAME_DESC,
CREATED_DESC,
CREATED_ASC
page
integer
défaut:1

Page number (1-indexed)

size
integer
défaut:20

Results per page

Plage requise: x <= 100

Réponse

Search results

data
object[]
pagination
object