Explorium V2 Prospects API

openapi: 3.2.0
info:
  title: Partner Service V2 Prospects API
  version: 0.3.19
servers:
- url: https://api.explorium.ai
  description: AgentSource Server
tags:
- name: V2Prospects
paths:
  /v2/prospects/match:
    post:
      tags:
      - V2Prospects
      summary: Match Prospects
      operationId: v2_prospects_match
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProspectsMatchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectsMatchResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
      - APIKeyHeader: []
  /v2/prospects:
    post:
      tags:
      - V2Prospects
      summary: Fetch Prospects
      operationId: v2_prospects_fetch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2ProspectsFetchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectsFetchResponseV2'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
      - APIKeyHeader: []
  /v2/prospects/stats:
    post:
      tags:
      - V2Prospects
      summary: Fetch Stats
      operationId: v2_prospects_stats
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2ProspectsStatsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectsStatsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
      - APIKeyHeader: []
components:
  schemas:
    IncludesFilter_NumberOfLocations_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            $ref: '#/components/schemas/NumberOfLocations'
          type: array
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[NumberOfLocations]
    ContactDetailsFilterValue:
      type: string
      enum:
      - email
      - phone
      - email_or_phone
      - email_and_phone
      title: ContactDetailsFilterValue
      description: An enumeration.
    ProspectsFetchResponseV2:
      properties:
        response_context:
          $ref: '#/components/schemas/ResponseContext'
        data:
          items:
            $ref: '#/components/schemas/Prospect'
          type: array
          title: Data
          description: List of prospects that match the filters.
          default: []
        total_results:
          type: integer
          minimum: 0.0
          title: Total Results
          description: The total number of prospects that match the filters.
          default: 0
        page:
          allOf:
          - $ref: '#/components/schemas/partner_service__models__prospects__requests__PageInfo'
          title: Page
          description: Page information including size and next cursor
      type: object
      required:
      - response_context
      - page
      title: ProspectsFetchResponseV2
      description: This is base response model for all responses in partner service.
    JobSeniorityLevel:
      type: string
      enum:
      - owner
      - c-suite
      - vice president
      - director
      - senior non-managerial
      - manager
      - partner
      - non-managerial
      - junior
      - president
      - senior manager
      - advisor
      - freelancer
      - board member
      - founder
      - training
      - unpaid
      title: JobSeniorityLevel
      description: 'The `JobSeniorityLevel` class is an enumeration that represents various levels of job seniority.


        This enum is used to categorize jobs based on their seniority levels, such as:

        - Entry-level positions

        - Managerial roles

        - Executive roles (e.g., C-Suite, VP)


        These categories ensure consistent filtering and classification of job-related data across the application.'
    V2ProspectsFetchRequest:
      properties:
        request_context:
          type: object
          title: Request Context
          marked_for_null_replacement: true
          nullable: true
        mode:
          allOf:
          - $ref: '#/components/schemas/BaseFetchMode'
          description: The mode of fetching prospects.
          example: full
        page_size:
          type: integer
          maximum: 500.0
          minimum: 1.0
          title: Page Size
          description: The maximum number of prospects in a page.
          example: 3
        exclude:
          items:
            type: string
            pattern: ^[a-f0-9]{40}$
          type: array
          maxItems: 1000
          title: Exclude
          marked_for_null_replacement: true
          nullable: true
        filters:
          allOf:
          - $ref: '#/components/schemas/V2ProspectsFetchFilters'
          title: Filters
          example: {}
          nullable: true
        next_cursor:
          type: string
          title: Next Cursor
          description: Cursor returned by the previous page. Omit or send null to start from the beginning.
          marked_for_null_replacement: true
          nullable: true
      additionalProperties: false
      type: object
      required:
      - mode
      - page_size
      title: V2ProspectsFetchRequest
    ProspectMatchOutput:
      properties:
        input:
          $ref: '#/components/schemas/ProspectMatchInput'
        prospect_id:
          type: string
          pattern: ^[a-f0-9]{40}$
          title: Prospect Id
      type: object
      required:
      - input
      title: ProspectMatchOutput
    IncludesFilter_StandardizedText_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[StandardizedText]
    JobDepartment:
      type: string
      enum:
      - administration
      - real estate
      - healthcare
      - partnerships
      - c-suite
      - design
      - human resources
      - engineering
      - education
      - strategy
      - product
      - sales
      - r&d
      - retail
      - customer success
      - security
      - public service
      - creative
      - it
      - support
      - marketing
      - trade
      - legal
      - operations
      - procurement
      - data
      - manufacturing
      - logistics
      - finance
      title: JobDepartment
      description: 'The `JobDepartment` class is an enumeration that represents various job departments.


        This enum is used to categorize jobs based on their associated departments, such as:

        - Engineering

        - Marketing

        - Sales

        - Legal

        - Customer Service


        These categories ensure consistent filtering and classification of job-related data across the application.'
    IncludesFilter_Text_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[Text]
    IncludesFilter_NAICS_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
            pattern: ^\d{2,6}$
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[NAICS]
    ExistsFilter:
      properties:
        negate:
          type: boolean
          title: Negate
        value:
          type: boolean
          title: Value
      additionalProperties: false
      type: object
      required:
      - value
      title: ExistsFilter
    RevenueRange:
      type: string
      enum:
      - 0-500K
      - 500K-1M
      - 1M-5M
      - 5M-10M
      - 10M-25M
      - 25M-75M
      - 75M-200M
      - 200M-500M
      - 500M-1B
      - 1B-10B
      - 10B-100B
      - 100B-1T
      - 1T-10T
      - 10T+
      title: RevenueRange
      description: The `RevenueRange` class is an enumeration that represents predefined ranges for the revenue of a company.
    ResponseContext:
      properties:
        correlation_id:
          type: string
          title: Correlation Id
        request_status:
          $ref: '#/components/schemas/RequestStatus'
        time_took_in_seconds:
          type: number
          title: Time Took In Seconds
      type: object
      required:
      - correlation_id
      - request_status
      - time_took_in_seconds
      title: ResponseContext
    NumberOfLocations:
      type: string
      enum:
      - 0-1
      - 2-5
      - 6-20
      - 21-50
      - 51-100
      - 101-1000
      - 1001+
      title: NumberOfLocations
      description: The `NumberOfLocations` class is an enumeration that represents predefined ranges
    V2ProspectsFetchFilters:
      properties:
        prospect_id:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_ProspectId_'
          title: Prospect ID
          description: Filter prospects by specific Explorium prospect IDs
          example:
            values:
            - edf268ac410ff3ba9ca9cc67b065664f38201984
            - 5b486640efabe6f8bb8cf446e80169ba4a1c5ad8
          nullable: true
        has_contact_details:
          allOf:
          - $ref: '#/components/schemas/ContactDetailsFilter'
          title: Has Contact Details
          description: Filter prospects by email and phone availability.
          example:
            value: email_or_phone
        job_level:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_JobSeniorityLevel_'
          title: Job Level
          description: 'Filter prospects by their job level. Categories: [director, manager, vp, partner, cxo, non-managerial, senior, entry, training, unpaid]'
          example:
            values:
            - owner
            - c-suite
            - vice president
            - director
            - senior non-managerial
            - manager
            - partner
            - non-managerial
            - junior
            - president
            - senior manager
            - advisor
            - freelancer
            - board member
            - founder
            - training
            - unpaid
        job_department:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_JobDepartment_'
          title: Job Department
          description: 'Filter prospects by their job department. Categories: [customer service, design, education, engineering, finance, general, health, sales, ...]'
          example:
            values:
            - administration
            - real estate
            - healthcare
            - partnerships
            - c-suite
            - design
            - human resources
            - engineering
            - education
            - strategy
            - product
            - sales
            - r&d
            - retail
            - customer success
            - security
            - public service
            - creative
            - it
            - support
            - marketing
            - trade
            - legal
            - operations
            - procurement
            - data
            - manufacturing
            - logistics
            - finance
        business_id:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_BusinessId_'
          title: Business ID
          description: 'Filter prospects by account. Use Explorium entity IDs. Maximum 10,000 items allowed. Example: [EXP_ENTITY_ID_1, EXP_ENTITY_ID_2]'
          example:
            values:
            - 8adce3ca1cef0c986b22310e369a0793
            - 340c8040bd50cbab9c7df718bbe51cc9
        total_experience_months:
          allOf:
          - $ref: '#/components/schemas/RangeFilter_Int_'
          title: Total Experience Months
          description: Filter by total months of experience.
          example:
            gte: 1
            lte: 10
        country_code:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_CountryCodeAlpha2_'
          title: Country Code
          description: 'Filter prospects by country using alpha-2 codes. Example: [us, ca]'
          example:
            values:
            - US
            - CA
        region_country_code:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_RegionCode_'
          title: Region Country Code
          description: 'Filter prospects by region using ISO 3166-2 codes. Example: [us-ut, us-ca]'
          example:
            values:
            - US-CA
            - IL-TA
        current_role_months:
          allOf:
          - $ref: '#/components/schemas/RangeFilter_Int_'
          title: Current Role Months
          description: Filter by number of months in current role.
          example:
            gte: 1
            lte: 10
        company_size:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_NumberOfEmployeesRange_'
          title: Company Size
          description: 'Filter by company’s number of employees. Options: [1-10, 11-50, ..., 10001+]'
          example:
            values:
            - 1-10
            - 11-50
            - 51-200
            - 201-500
            - 501-1000
            - 1001-5000
            - 5001-10000
            - 10001+
        company_revenue:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_RevenueRange_'
          title: Company Revenue
          description: 'Filter by company’s annual revenue. Options: [0-500K, 500K-1M, ..., 10B-100B]'
          example:
            values:
            - 0-500K
            - 500K-1M
            - 1M-5M
            - 5M-10M
            - 10M-25M
            - 25M-75M
            - 75M-200M
            - 200M-500M
            - 500M-1B
            - 1B-10B
            - 10B-100B
            - 100B-1T
            - 1T-10T
            - 10T+
        company_age:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_CompanyAgeRange_'
          title: Company Age
          description: 'Filter by company age. Options: [0-3, 3-6, 6-10, 10-20, 20+]'
          example:
            values:
            - 0-3
            - 3-6
            - 6-10
            - 10-20
            - 20+
        company_number_of_locations:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_NumberOfLocations_'
          title: Number Of Locations
          description: 'Filter by company office count. Options: [0-1, 2-5, 6-20, 21-50, 51-100, 101-1000, 1001+]'
          example:
            values:
            - 0-1
            - 2-5
            - 6-20
            - 21-50
            - 51-100
            - 101-1000
            - 1001+
        google_category:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_StandardizedText_'
          title: Google Category
          description: 'Filter by company’s Google business category. Example: [Paving contractor, Retail]'
          example:
            values:
            - construction
        naics_category:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_NAICS_'
          title: NAICS Category
          description: 'Filter by NAICS code (2, 4, or full). Example: [23, 5611]'
          example:
            values:
            - '541512'
        linkedin_category:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_Text_'
          title: LinkedIn Category
          description: 'Filter by company’s LinkedIn business category. Example: [software development, investment banking]'
          example:
            values:
            - retail
        job_title:
          allOf:
          - $ref: '#/components/schemas/JobTitleFilter'
          title: Job Title
          description: 'Filter prospects by their job titles. Supports include_related_job_titles parameter. Example: [Sales Representative, SEO specialist, Technical Support Engineer]'
          example:
            values:
            - Software Engineer
            - Data Scientist
            include_related_job_titles: false
        skills:
          allOf:
          - $ref: '#/components/schemas/AnyMatchPhraseFilter_Text_'
          title: Skills
          description: 'Filter prospects by skills. Example: [python, project management]'
          example:
            values:
            - python
            - project management
          nullable: true
        interests:
          allOf:
          - $ref: '#/components/schemas/AnyMatchPhraseFilter_Text_'
          title: Interests
          description: 'Filter prospects by interests. Values should come from the interests autocomplete field. Example: [diy, travel]'
          example:
            values:
            - diy
            - travel
          nullable: true
        company_country_code:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_CountryCodeAlpha2_'
          title: Company Country Code
          description: 'Filter by company HQ country using alpha-2 codes. Example: [us, ca]'
          example:
            values:
            - US
            - CA
        company_region_country_code:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_RegionCode_'
          title: Company Region Country Code
          description: 'Filter by company HQ region using ISO 3166-2 codes. Example: [us-ut, us-ca]'
          example:
            values:
            - US-CA
            - IL-TA
        city_region_country:
          allOf:
          - $ref: '#/components/schemas/IncludesFilter_Text_'
          title: City Region Country
          description: Filter by city region country.
          example:
            values:
            - Paris, FR
            - Tel Aviv, IL
            - Miami, FL, US
        company_name:
          allOf:
          - $ref: '#/components/schemas/AnyMatchFilter_OrganizationName_'
          title: Company Name
          description: 'Filter by company name. Example: [Meta, Tesla]'
          example:
            values:
            - Microsoft
            - Google
        has_website:
          allOf:
          - $ref: '#/components/schemas/ExistsFilter'
          title: Has Website
          description: 'Filter prospects by whether their company has a website. Categories: [True, False]'
          example:
            value: true
          nullable: true
        is_public_company:
          allOf:
          - $ref: '#/components/schemas/ExistsFilter'
          title: Is Public Company
          description: Filter prospects by whether their company is publicly traded.
          example:
            value: true
          nullable: true
      additionalProperties: false
      type: object
      title: V2ProspectsFetchFilters
      example: {}
    AnyMatchFilter_OrganizationName_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
            maxLength: 256
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: AnyMatchFilter[OrganizationName]
    IncludesFilter_JobSeniorityLevel_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            $ref: '#/components/schemas/JobSeniorityLevel'
          type: array
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[JobSeniorityLevel]
    ProspectsMatchRequest:
      properties:
        request_context:
          type: object
          title: Request Context
          marked_for_null_replacement: true
          nullable: true
        prospects_to_match:
          items:
            $ref: '#/components/schemas/ProspectMatchInput'
          type: array
          maxItems: 50
          minItems: 1
          title: Prospects To Match
      additionalProperties: false
      type: object
      required:
      - prospects_to_match
      title: ProspectsMatchRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    IncludesFilter_CountryCodeAlpha2_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
            pattern: ^(aw|af|ao|ai|ax|al|ad|ae|ar|am|as|aq|tf|ag|au|at|az|bi|be|bj|bq|bf|bd|bg|bh|bs|ba|bl|by|bz|bm|bo|br|bb|bn|bt|bv|bw|cf|ca|cc|ch|cl|cn|ci|cm|cd|cg|ck|co|km|cv|cr|cu|cw|cx|ky|cy|cz|de|dj|dm|dk|do|dz|ec|eg|er|eh|es|ee|et|fi|fj|fk|fr|fo|fm|ga|gb|ge|gg|gh|gi|gn|gp|gm|gw|gq|gr|gd|gl|gt|gf|gu|gy|hk|hm|hn|hr|ht|hu|id|im|in|io|ie|ir|iq|is|il|it|jm|je|jo|jp|kz|ke|kg|kh|ki|kn|kr|kw|la|lb|lr|ly|lc|li|lk|ls|lt|lu|lv|mo|mf|ma|mc|md|mg|mv|mx|mh|mk|ml|mt|mm|me|mn|mp|mz|mr|ms|mq|mu|mw|my|yt|na|nc|ne|nf|ng|ni|nu|nl|no|np|nr|nz|om|pk|pa|pn|pe|ph|pw|pg|pl|pr|kp|pt|py|ps|pf|qa|re|ro|ru|rw|sa|sd|sn|sg|gs|sh|sj|sb|sl|sv|sm|so|pm|rs|ss|st|sr|sk|si|se|sz|sx|sc|sy|tc|td|tg|th|tj|tk|tm|tl|to|tt|tn|tr|tv|tw|tz|ug|ua|um|uy|us|uz|va|vc|ve|vg|vi|vn|vu|wf|ws|xk|ye|za|zm|zw)$
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[CountryCodeAlpha2]
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    partner_service__models__prospects__requests__PageInfo:
      properties:
        size:
          type: integer
          title: Size
          description: Number of results in this page
        next_cursor:
          type: string
          title: Next Cursor
          description: Cursor for pagination. Use this value as cursor in the next request.
      type: object
      required:
      - size
      title: PageInfo
    ProspectsStats:
      properties:
        job_departments_per_location:
          type: object
          title: Job Departments Per Location
        total_per_location:
          type: object
          title: Total Per Location
      type: object
      title: ProspectsStats
    RequestStatus:
      type: string
      enum:
      - success
      - miss
      - failure
      title: RequestStatus
      description: "The `RequestStatus` class is an enumeration that defines the possible statuses of a request.\n\nThis enum is used to indicate whether a request was successful, missed, or failed. It ensures\nconsistent handling of request statuses across the application.\n\nAttributes:\n    SUCCESS: Indicates that the request was successfully processed.\n    MISS: Indicates that the request did not find any matching data.\n    FAILURE: Indicates that the request encountered an error or failure."
    AnyMatchPhraseFilter_Text_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
          type: array
          title: Values
        operator:
          type: string
          enum:
          - or
          - and
          title: Operator
          default: or
      additionalProperties: false
      type: object
      required:
      - values
      title: AnyMatchPhraseFilter[Text]
    NumberOfEmployeesRange:
      type: string
      enum:
      - 1-10
      - 11-50
      - 51-200
      - 201-500
      - 501-1000
      - 1001-5000
      - 5001-10000
      - 10001+
      title: NumberOfEmployeesRange
      description: 'The `NumberOfEmployeesRange` class is an enumeration that represents predefined ranges

        for the number of employees in a company. These ranges are used for filtering and

        categorizing companies based on their workforce size.'
    IncludesFilter_RevenueRange_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            $ref: '#/components/schemas/RevenueRange'
          type: array
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[RevenueRange]
    BaseFetchMode:
      type: string
      enum:
      - full
      - preview
      title: BaseFetchMode
      description: "The `BaseFetchMode` class is an enumeration that defines the modes for fetching data.\n\nThis enum is used to specify whether the fetch operation should retrieve the full data\nor just a preview of the data. It ensures consistent handling of fetch modes across\nthe application.\n\nAttributes:\n    FULL: Fetch the complete data.\n    PREVIEW: Fetch a preview or partial data."
    RangeFilter_Int_:
      properties:
        negate:
          type: boolean
          title: Negate
        gte:
          type: integer
          title: Gte
        lte:
          type: integer
          title: Lte
      additionalProperties: false
      type: object
      title: RangeFilter[Int]
    IncludesFilter_BusinessId_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
            pattern: ^[a-f0-9]{32}$
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[BusinessId]
    CompanyAgeRange:
      type: string
      enum:
      - 0-3
      - 3-6
      - 6-10
      - 10-20
      - 20+
      title: CompanyAgeRange
      description: 'The `CompanyAgeRange` class is an enumeration that inherits from `BaseFilterEnum`.


        It represents predefined ranges for the age of a company, such as "0-3 years" or "20+ years".

        This enum is used to categorize companies based on their age, ensuring consistent filtering

        and comparison across the application. Each range is defined as a string value for easy

        conversion and usage.'
    ProspectsMatchResponse:
      properties:
        response_context:
          $ref: '#/components/schemas/ResponseContext'
        total_results:
          type: integer
          exclusiveMinimum: 0.0
          title: Total Results
          description: The total_results number matched prospects
        total_matches:
          type: integer
          minimum: 0.0
          title: Total Matches
          description: The total number of matches.
        matched_prospects:
          items:
            anyOf:
            - $ref: '#/components/schemas/ProspectMatchOutputWithError'
            - $ref: '#/components/schemas/ProspectMatchOutput'
          type: array
          title: Matched Prospects
          description: A list of matched prospects ids represented by MD5 hashes. May contain None for unmatched items.
          default: []
      type: object
      required:
      - response_context
      - total_results
      - total_matches
      title: ProspectsMatchResponse
      description: This is base response model for all responses in partner service.
    IncludesFilter_NumberOfEmployeesRange_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            $ref: '#/components/schemas/NumberOfEmployeesRange'
          type: array
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[NumberOfEmployeesRange]
    ContactDetailsFilter:
      properties:
        value:
          $ref: '#/components/schemas/ContactDetailsFilterValue'
        negate:
          type: boolean
          title: Negate
      additionalProperties: false
      type: object
      required:
      - value
      title: ContactDetailsFilter
    ProspectMatchInput:
      properties:
        business_id:
          type: string
          title: Business Id
          description: Explorium business id
          marked_for_null_replacement: true
          nullable: true
        full_name:
          type: string
          title: Full Name
          description: Full name of the person
          marked_for_null_replacement: true
          nullable: true
        company_name:
          type: string
          title: Company Name
          description: Company name
          marked_for_null_replacement: true
          nullable: true
        email:
          type: string
          title: Email
          description: Email address
          marked_for_null_replacement: true
          nullable: true
        phone_number:
          type: string
          title: Phone Number
          description: Phone number
          marked_for_null_replacement: true
          nullable: true
        linkedin:
          type: string
          title: Linkedin
          description: LinkedIn URL
          marked_for_null_replacement: true
          nullable: true
      type: object
      title: ProspectMatchInput
    ProspectMatchOutputWithError:
      properties:
        input:
          $ref: '#/components/schemas/ProspectMatchInput'
        prospect_id:
          type: string
          pattern: ^[a-f0-9]{40}$
          title: Prospect Id
        error:
          type: string
          title: Error
        error_type:
          type: string
          title: Error Type
      type: object
      required:
      - input
      - error
      - error_type
      title: ProspectMatchOutputWithError
    IncludesFilter_JobDepartment_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            $ref: '#/components/schemas/JobDepartment'
          type: array
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[JobDepartment]
    ProspectsStatsResponse:
      properties:
        response_context:
          $ref: '#/components/schemas/ResponseContext'
        total_results:
          type: integer
          title: Total Results
        stats:
          $ref: '#/components/schemas/ProspectsStats'
      type: object
      required:
      - response_context
      - total_results
      - stats
      title: ProspectsStatsResponse
      description: This is base response model for all responses in partner service.
    IncludesFilter_ProspectId_:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
            pattern: ^[a-f0-9]{40}$
          type: array
          title: Values
      additionalProperties: false
      type: object
      required:
      - values
      title: IncludesFilter[ProspectId]
    JobTitleFilter:
      properties:
        negate:
          type: boolean
          title: Negate
        values:
          items:
            type: string
          type: array
          maxItems: 300
          title: Job Titles
          description: List of job titles to filter by. Maximum 300 items allowed.
          example:
          - Software Engineer
          - Data Scientist
        operator:
          type: string
          enum:
          - or
          - and
          title: Operator
          default: or
        include_related_job_titles:
          type: boolean


# --- truncated at 32 KB (125 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/explorium/refs/heads/main/openapi/explorium-v2prospects-api-openapi.yml