Skip to main content
POST
/
v1
/
search
Search records
curl --request POST \
  --url https://app.nex.ai/api/developers/v1/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "john doe"
}
'
{
  "results": {
    "person": [
      {
        "id": "1001",
        "primary_value": "John Doe",
        "matched_value": "John Doe",
        "score": 0.95,
        "entity_definition_id": "10"
      }
    ],
    "company": [
      {
        "id": "2001",
        "primary_value": "Doe Industries",
        "matched_value": "Doe Industries",
        "score": 0.72,
        "entity_definition_id": "11"
      }
    ]
  },
  "errored_search_types": []
}

Authorizations

Authorization
string
header
required

API key for authentication (format: "Bearer YOUR_API_KEY")

Body

application/json

Search query

query
string
required

Search query (1-500 characters)

Response

Search results grouped by type

results
object

Results grouped by object type (e.g., 'person', 'company')

errored_search_types
string[]

Search types that encountered errors (partial results returned)

Last modified on March 7, 2026