# Search contacts

Search contacts using advanced filters with pagination and sorting. Use this to find contacts by any combination of fields — name, company, email status, pipeline stage, tags, and more.

Endpoint: POST /leads/api/leads/search
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `filter` (object)
    Filter criteria. Supports scalar values (equals), arrays (IN), objects with operators (>=, <=, etc.), "is_null", "is_not_null".
    Example: {"company_name":"Acme Inc","email_status":"ok"}

  - `limit` (integer)
    Number of results to return.
    Example: 20

  - `offset` (integer)
    Number of results to skip.

  - `order_field` (string)
    Field to sort by.
    Example: "name"

  - `order_type` (string)
    Sort direction.
    Enum: "asc", "desc"

  - `disable_aggregation` (boolean)
    Skip enrichment data aggregation.

## Response 200 fields (application/json):

  - `data` (array)

  - `data.uuid` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `data.team_id` (integer)

  - `data.user_id` (integer,null)

  - `data.sender_profile_uuid` (string,null)

  - `data.list_uuid` (string)

  - `data.data_source_uuid` (string,null)

  - `data.pipeline_stage_uuid` (string)

  - `data.company_uuid` (string,null)

  - `data.name` (string,null)
    Example: "John Doe"

  - `data.first_name` (string,null)
    Example: "John"

  - `data.last_name` (string,null)
    Example: "Doe"

  - `data.company_name` (string,null)
    Example: "Acme Inc"

  - `data.company_ln_id` (string,null)

  - `data.position` (string,null)
    Example: "VP of Sales"

  - `data.headline` (string,null)
    Example: "VP of Sales at Acme Inc"

  - `data.about` (string,null)

  - `data.avatar_url` (string,null)

  - `data.ln_id` (string,null)
    LinkedIn member ID.

  - `data.sn_id` (string,null)
    Sales Navigator ID.

  - `data.linkedin` (string,null)
    Example: "john-doe-123456"

  - `data.facebook` (string,null)

  - `data.twitter` (string,null)

  - `data.work_email` (string,null)
    Example: "john@acme.com"

  - `data.personal_email` (string,null)

  - `data.work_phone_number` (string,null)

  - `data.personal_phone_number` (string,null)

  - `data.connections_number` (integer,null)

  - `data.followers_number` (integer,null)

  - `data.primary_language` (string,null)

  - `data.supported_languages` (array,null)

  - `data.has_open_profile` (integer,null)

  - `data.has_verified_profile` (integer,null)

  - `data.has_premium` (integer,null)

  - `data.experience` (array,null)

  - `data.experience.title` (string)

  - `data.experience.company` (string)

  - `data.experience.start_date` (string)

  - `data.experience.end_date` (string)

  - `data.posts` (array,null)

  - `data.posts.content` (string)

  - `data.posts.date` (string)

  - `data.educations` (array,null)

  - `data.educations.school` (string)

  - `data.educations.degree` (string)

  - `data.educations.field_of_study` (string)

  - `data.educations.start_year` (string)

  - `data.educations.end_year` (string)

  - `data.skills` (array,null)

  - `data.raw_address` (string,null)
    Example: "San Francisco, CA, USA"

  - `data.location` (array,null)

  - `data.location.address_string` (string)

  - `data.tags` (array,null)
    Tag UUIDs.

  - `data.status` (string)
    Example: "ok"

  - `data.linkedin_status` (string)
    Example: "active"

  - `data.email_status` (string,null)

  - `data.unread_counts` (array)

  - `data.unread_counts.category` (string)

  - `data.unread_counts.count` (integer)

  - `data.last_automation_approve_at` (string,null)

  - `data.created_at` (string,null)

  - `data.updated_at` (string,null)

  - `limit` (integer)
    Example: 20

  - `offset` (integer)

  - `total` (integer)
    Example: 142

## Response 422 fields (application/json):

  - `error` (object)

  - `error.reason` (string)
    Machine-readable error code: validation_error, bad_request, auth_exception, access_denied, payment_required.
    Example: "validation_error"

  - `error.message` (string)
    Example: "The name field is required."

  - `error.data` (object)
    Field-level validation errors (field name → messages).

  - `message` (string)
    Example: "The given data was invalid."

  - `code` (integer)
    Example: 422