# Search contacts

Searches contacts using advanced filters, sorting, and pagination. Returns a list of matched contacts with optional aggregation.

### Supported Filter Value Types:

-  →  query
    

-  → Comparison query with operators
    

    Supported operators: , , `>="is_null"IS NULL"is_not_null"IS NOT NULL"linkedin_status": "ok"`


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

## Request fields (application/json):

  - `filter` (object)
    Filters to apply when searching contacts.
    Example: {"name":"John Smith","company_name":"Example Inc.","email_status":"ok"}

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

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

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

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

  - `disable_aggregation` (boolean)
    If true, disables contact data aggregation in the response.

## Response 200 fields (application/json):

  - `data` (array)
    List of found contacts

  - `data.uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.team_id` (integer)
    Example: 1

  - `data.user_id` (integer,null)
    Example: 1

  - `data.sender_profile_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.list_uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.data_source_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.pipeline_stage_uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.company_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data.name` (string,null)
    Example: "Christina Sletner"

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

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

  - `data.company_name` (string,null)
    Example: "Advania Norge"

  - `data.company_ln_id` (string,null)
    Example: "98"

  - `data.position` (string,null)
    Example: "Sales & Partner Manager"

  - `data.headline` (string,null)
    Example: "Sales & Partner Manager I ERP-/Dynamics 365 Finance/OnSite 365 at Advania Norge"

  - `data.about` (string,null)
    Example: "Busy times with contributing to our customers' cloud journey..."

  - `data.avatar_url` (string,null)
    Example: "https://example.com/avatar.jpg"

  - `data.ln_id` (string,null)
    Example: "ACoAAAB6GuQBOXo75numqJfM9u08uHgjOSo4p9U"

  - `data.sn_id` (string,null)
    Example: "ACwAAAB6GuQBEz2TMHbG4sa7Nw5wSi7cJXMQkPI"

  - `data.linkedin` (string,null)
    Example: "christina-sletner-b4481a2"

  - `data.facebook` (string,null)
    Example: "christina-sletner"

  - `data.twitter` (string,null)
    Example: "christina-sletner"

  - `data.work_email` (string,null)
    Example: "christina.sletner@advania.no"

  - `data.personal_email` (string,null)
    Example: "christina88@yahoo.com"

  - `data.work_phone_number` (string,null)
    Example: "+123456789"

  - `data.personal_phone_number` (string,null)
    Example: "+123456789"

  - `data.connections_number` (integer,null)
    Example: 500

  - `data.followers_number` (integer,null)
    Example: 1000

  - `data.primary_language` (string,null)
    Example: "en"

  - `data.supported_languages` (array,null)
    Example: ["en","no"]

  - `data.has_open_profile` (integer,null)
    Example: 1

  - `data.has_verified_profile` (integer,null)
    Example: 1

  - `data.has_premium` (integer,null)
    Example: 1

  - `data.experience` (array,null)

  - `data.experience.title` (string)
    Example: "Sales Manager"

  - `data.experience.company` (string)
    Example: "Advania Norge"

  - `data.experience.start_date` (string)
    Example: "2018-01-01"

  - `data.experience.end_date` (string)
    Example: "2022-12-31"

  - `data.posts` (array,null)

  - `data.posts.content` (string)
    Example: "Just attended a great conference on cloud computing!"

  - `data.posts.date` (string)
    Example: "2022-05-15T09:30:00Z"

  - `data.educations` (array,null)

  - `data.educations.school` (string)
    Example: "University of Oslo"

  - `data.educations.degree` (string)
    Example: "MBA"

  - `data.educations.field_of_study` (string)
    Example: "Business Administration"

  - `data.educations.start_year` (string)
    Example: "2012"

  - `data.educations.end_year` (string)
    Example: "2014"

  - `data.skills` (array,null)
    Example: ["Project Management","Sales","ERP Systems"]

  - `data.top_voices` (array,null)
    Example: ["Thought Leader 1","Influencer 2"]

  - `data.raw_address` (string,null)
    Example: "Oslo, Oslo, Norway"

  - `data.location` (array,null)

  - `data.location.address_string` (string)
    Example: "Oslo, Oslo, Norway"

  - `data.tags` (array,null)
    Example: ["uuid-uuid-uuid-uuid-example","uuid-uuid-uuid-uuid-example"]

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

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

  - `data.email_status` (string,null)
    Example: "verified"

  - `data.unread_counts` (array)

  - `data.unread_counts.category` (string)
    Example: "messages"

  - `data.unread_counts.count` (integer)
    Example: 5

  - `data.last_automation_approve_at` (string,null)
    Example: "2023-07-21T10:15:30Z"

  - `data.created_at` (string,null)
    Example: "2022-12-11T10:00:00Z"

  - `data.updated_at` (string,null)
    Example: "2022-12-11T11:00:00Z"

  - `limit` (integer)
    Example: 20

  - `offset` (integer)

  - `total` (integer)
    Total number of contacts matching the filter
    Example: 142

## Response 422 fields (application/json):

  - `message` (string)
    Example: "Validation failed for input parameters"