Passer au contenu principal
POST
/
v2
/
api
/
crm
/
deals
/
search
Search deals
curl --request POST \
  --url https://api.withallo.com/v2/api/crm/deals/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search": "Enterprise",
  "page": 1,
  "size": 20
}
'
{
  "data": [
    {
      "id": "dea-def456",
      "name": "Enterprise Plan",
      "status": "negotiation",
      "amount": 50000,
      "currency": "USD",
      "closed_at": null,
      "company": {
        "id": "com-xyz789",
        "name": "Acme Corp"
      },
      "created_at": "2026-04-15T14: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 le nom du deal et l’entreprise
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

ChampType de correspondanceDescription
stageexactEtape/statut du deal

Autorisations

Authorization
string
header
requis

Corps

application/json

Request body for searching deals

filters
object

Named filters. Combined with AND.

search
string | null

Free-text search across deal name 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