Menu

Search

1 endpoint in the Mattering Sales API.

GET search/ User APIService tier

Search contacts, companies and deals by name, email, phone, domain or title.

Query: q (trimmed; under 2 characters returns no rows) and limit (default 8, 1 to 20, the cap for the whole response). Rows are {type, type_label, id, title, subtitle, path}, best match first, spread across the three types. Response: ``{data: [...], meta: {query, count}}``.

URL

  • User APIhttps://sales.mattering.io/api/user/v1/search/
  • Service tierhttps://sales.mattering.io/api/internal/search/

Query parameters

NameDefault
limitnone
qnone

Responses

200 data and meta envelope

{
  "data": "...",
  "meta": {
    "query": "...",
    "count": 0
  }
}

200 data and meta envelope

{
  "data": [],
  "meta": {
    "query": "...",
    "count": 0
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401unauthorized
403org_required

Example

curl -X GET "https://sales.mattering.io/api/user/v1/search/?limit=...&q=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: CRMCore/search_api.py (search_api.search)

All Sales resources
Start Free Explore our Products