Lusha

Lusha Contact Filters API

Available filters for contact searches

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /prospecting/filters/contacts/departments List departments for contact filters · Departments #
Ask an LLM
“What departments can I filter contacts by?”
“Which department names does contact prospecting accept?”
Tell an agent
List the available contact departments.
Show me every department I can filter contacts on.
GET /prospecting/filters/contacts/seniority List seniority levels for contact filters · Seniority #
Ask an LLM
“What seniority levels can I filter contacts by?”
“Which seniority values exist, like VP or director?”
Tell an agent
List the available contact seniority levels.
Show the seniority options for filtering contacts.
GET /prospecting/filters/contacts/existing_data_points List contact data points to filter on · Data Points #
Ask an LLM
“Can I filter to contacts that have a phone number or email on file?”
“Which existing data points can I require on contacts?”
Tell an agent
List the data points I can filter contacts by.
Show the existing data point options for contact filters.
GET /prospecting/filters/contacts/all_countries List countries for contact filters · Countries #
Ask an LLM
“Which countries can I filter contacts by?”
“Where do I get the full country list for contact prospecting?”
Tell an agent
List every country available for contact filtering.
Show me the country values for contact filters.
POST /prospecting/filters/contacts/locations Look up contact locations for filtering · Locations #
Ask an LLM
“How do I find a city or state to filter contacts by?”
“Can I search contact locations by text?”
Tell an agent
Look up contact locations matching {text}.
Find the contact location filter value for {text}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/openapi/lusha-contact-filters-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lusha:lusha-contact-filters-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lusha-contact-filters-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lusha API Documentation Contact Filters API
  version: ''
  x-logo:
    url: https://www.lusha.com/logo.png
  license:
    name: Proprietary
    url: https://lusha.com/legal/terms
  description: ⚠️ **This version is soon to be deprecated.** Please migrate to V3.
  contact:
    name: Lusha Support
    url: https://api.lusha.com
    email: support@lusha.com
  termsOfService: https://lusha.com/legal/terms
  x-privacy-policy:
    name: Privacy Policy
    url: https://lusha.com/legal/privacy-notice/
servers:
- url: https://api.lusha.com
  description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Contact Filters
  description: Available filters for contact searches
  x-parent-tag: Prospecting
paths:
  /prospecting/filters/contacts/departments:
    get:
      tags:
      - Contact Filters
      summary: Departments
      description: Get list of available departments for contact filtering
      operationId: getContactDepartments
      responses:
        '200':
          description: List of departments
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              example:
              - Business Development
              - Consulting
              - Engineering
              - Marketing
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/contacts/seniority:
    get:
      tags:
      - Contact Filters
      summary: Seniority
      description: Get list of available seniority levels for contact filtering
      operationId: getContactSeniority
      responses:
        '200':
          description: List of seniority levels
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              example:
              - id: 10
                name: founder
              - id: 9
                name: c-suite
              - id: 8
                name: vice president
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/contacts/existing_data_points:
    get:
      tags:
      - Contact Filters
      summary: Data Points
      description: Get list of available data points for contact filtering
      operationId: getContactDataPoints
      responses:
        '200':
          description: List of data points
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              example:
              - phone
              - work_email
              - mobile_phone
              - direct_phone
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/contacts/all_countries:
    get:
      tags:
      - Contact Filters
      summary: Countries
      description: Get list of all available countries for contact filtering
      operationId: getContactCountries
      responses:
        '200':
          description: List of countries with codes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CountryFilter'
              example:
              - name: United States
                code: US
              - name: United Kingdom
                code: GB
        '401':
          $ref: '#/components/responses/Unauthorized'
  /prospecting/filters/contacts/locations:
    post:
      tags:
      - Contact Filters
      summary: Locations
      description: Search for locations by text for contact filtering
      operationId: searchContactLocations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LocationSearchRequest'
            example:
              text: un
      responses:
        '200':
          description: Matching locations
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LocationFilter'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
      - statusCode
      - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code
          example: 400
        message:
          type: string
          description: Error message
          example: Validation failed
        errors:
          type: array
          items:
            type: string
          description: Detailed error messages (optional, only for validation errors)
          example:
          - 'entityType must be one of: contact, company'
    LocationFilter:
      type: object
      properties:
        continent:
          type: string
          example: North America
        country:
          type: string
          example: United States
        city:
          type: string
          example: New York
        state:
          type: string
          example: New York
        country_grouping:
          type: string
          example: na
    LocationSearchRequest:
      type: object
      properties:
        text:
          type: string
          description: Search text for location
          example: un
      required:
      - text
    CountryFilter:
      type: object
      properties:
        name:
          type: string
          example: United States
        code:
          type: string
          example: US
      required:
      - name
      - code
  responses:
    Unauthorized:
      description: Unauthorized - invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            statusCode: 401
            message: Invalid API key
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: 'Your Lusha API key. You can find this in your Lusha dashboard under API settings.


        Include this key in the `api_key` header for all requests.

        '