---
title: "Search InvestorMatch Entities"
method: POST
path: "/data/searches/investor_matches"
tags: ["Search"]
---

# Search InvestorMatch Entities

`POST /data/searches/investor_matches`

Can perform more complex filtering based on the query defined in the request body

## Request body

- InvestorMatchEntitySearch — EntitySearch for InvestorMatch search
  - `after_id` string, uuid — Used to paginate search results to the next page. after_id should be the uuid of the last item in the current page. May not be provided simultaneously with before_id.
  - `before_id` string, uuid — Used to paginate search results to the previous page. before_id should be the uuid of the first item in the current page. May not be provided simultaneously with after_id.
  - `field_ids` string[], required — The list of field_ids to include in the result
  - `limit` integer — Number of rows to return. Default is 100, min is 1, max is 1000.
  - `order` Order[] — Order in which the search results should be returned
    - `field_id` string, required — Name of the field to sort on
    - `nulls` 'first' | 'last'
    - `sort` 'asc' | 'desc', required
  - `query` Predicate[], required — Search query to perform on the designated entity
    - `field_id` string, required — The field to operate on
    - `operator_id` 'blank' | 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'starts' | 'contains' | 'not_contains' | 'between' | 'includes' | 'not_includes' | 'includes_all' | 'not_includes_all' | 'domain_eq' | 'not_domain_eq' | 'domain_blank' | 'domain_includes' | 'not_domain_includes', required — Search operations for use in predicates * between - Between. Provide two values in "values" * blank - Is blank. Possible values in "values" is "true" or "false" * contains - Contains * domain_blank - Domain is blank. Possible values in "values" is "true" or "false" * domain_eq - Domain equals * domain_includes - Domain includes any * eq - Equals * gt - Greater than * gte - Greater than or equal to * includes - Includes any * includes_all - Includes all * lt - Less than * lte - Less than or equal to * not_contains - Does not contain * not_domain_eq - Domain not equal * not_domain_includes - Domain does not include * not_eq - Does not equal * not_includes - Does not include * not_includes_all - Does not include all * starts - Starts with
    - `type` 'predicate', required — The type of the query (Predicate)
    - `values` union[] — Values array with data type matching field_id type
      - union
        - string
        - number
        - boolean

## Response `200`

Results are identifiers matching the search query

- object — Search results include InvestorMatch entities
  - `count` integer — Total number of InvestorMatch entities
  - `entities` object[] — List of InvestorMatch entities
    - `properties` InvestorMatch
      - `created_at` string, date-time — Time of creation
      - `entity_def_id` 'investor_match' — Entity Def Type * investor_match - Investor Match
      - `identifier` EntityIdentifier, required — Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required — Universally Unique Identifier
        - `value` string
      - `investor` EntityIdentifier — Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required — Universally Unique Identifier
        - `value` string
      - `local_rank` number — Ranking indicating the strength of the investor match
      - `organization` EntityIdentifier — Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required — Universally Unique Identifier
        - `value` string
      - `updated_at` string, date-time — Time of Update
      - `uuid` string, uuid — UUID
    - `uuid` string, uuid — UUID of the entity

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Request Failed

---

[API](https://skmtc.net/crunchbase/apis/firmographic-package.md) · [All operations](https://skmtc.net/crunchbase/apis/firmographic-package/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchbase/firmographic-package/versions/3277c0d3e46a/schema)
