Leads

Search leads

Find leads by name, email, company, title, or handle. Every word in query must appear. Use the id with Get a lead.

POST

/api/v1/leads/search

Request bodyrequired

queryrequired

string

Text to match. Every word must appear in the record.

Response

200Matching leads.

leads

object[]

Up to 20 matches.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy