> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sumble: Find Organizations

> Search companies by technology, job function, location, size and other filters, sorted by the column you choose. Includes SDK V2 examples, schemas, and cost.

Search companies by technology, job function, location, size and other filters, sorted by the column you choose.

> [!NOTE]
>
> Tool ID: `sumble_find_organizations`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'sumble_find_organizations',
  {
    "filters": {
      "technologies": [],
      "technology_categories": [],
      "since": "example"
    }
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute sumble_find_organizations --input '{
  "filters": {
    "technologies": [],
    "technology_categories": [],
    "since": "example"
  }
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe sumble_find_organizations --json` for the complete live contract.

## Input reference

Find organizations

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filters` | `object` | Yes | — | Filters to apply to the people search. Can be either a Filters object or a Query object. |
| `payload.order_by_column` | `"industry" \| "employee_count" \| "employee_count_int" \| "first_activity_time" \| "last_activity_time" \| "jobs_count" \| "teams_count" \| "people_count" \| "jobs_count_growth_6mo" \| "cloud_spend_estimate_millions_usd" \| "account_score"` | No | — | Column to order by Allowed: `industry`, `employee_count`, `employee_count_int`, `first_activity_time`, `last_activity_time`, `jobs_count`, `teams_count`, `people_count`, `jobs_count_growth_6mo`, `cloud_spend_estimate_millions_usd`, `account_score`. |
| `payload.order_by_direction` | `"ASC" \| "DESC"` | No | — | Direction to order by Allowed: `ASC`, `DESC`. |
| `payload.include_entity_details` | `boolean` | No | `false` | Whether to include entity-specific data (matching\_entities) in the response |
| `payload.limit` | `integer` | No | `10` | Maximum number of results to return Minimum: 1. Maximum: 200. |
| `payload.offset` | `integer` | No | `0` | Number of results to skip Minimum: 0. Maximum: 10000. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Find organizations",
    "properties": {
      "filters": {
        "description": "Filters to apply to the people search. Can be either a Filters object or a Query object.",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "technologies": {
                "type": "array",
                "description": "Technologies to search for",
                "default": [],
                "items": {
                  "type": "string"
                }
              },
              "technology_categories": {
                "type": "array",
                "description": "Technology categories to search for",
                "default": [],
                "items": {
                  "type": "string"
                }
              },
              "since": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Only consider data since this date. Format: YYYY-MM-DD"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "query": {
                "type": "string"
              }
            },
            "required": [
              "query"
            ],
            "additionalProperties": false
          }
        ]
      },
      "order_by_column": {
        "type": [
          "string",
          "null"
        ],
        "description": "Column to order by",
        "enum": [
          "industry",
          "employee_count",
          "employee_count_int",
          "first_activity_time",
          "last_activity_time",
          "jobs_count",
          "teams_count",
          "people_count",
          "jobs_count_growth_6mo",
          "cloud_spend_estimate_millions_usd",
          "account_score"
        ]
      },
      "order_by_direction": {
        "type": [
          "string",
          "null"
        ],
        "description": "Direction to order by",
        "enum": [
          "ASC",
          "DESC"
        ]
      },
      "include_entity_details": {
        "type": "boolean",
        "description": "Whether to include entity-specific data (matching_entities) in the response",
        "default": false
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results to return",
        "default": 10,
        "minimum": 1,
        "maximum": 200
      },
      "offset": {
        "type": "integer",
        "description": "Number of results to skip",
        "default": 0,
        "minimum": 0,
        "maximum": 10000
      }
    },
    "required": [
      "filters"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.organizations` | `array` | Yes | — | — |
| `result.data.organizations[].id` | `integer` | Yes | — | — |
| `result.data.organizations[].parent_id` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].name` | `string` | Yes | — | — |
| `result.data.organizations[].url` | `string` | Yes | — | Format: `uri`. Minimum length: 1. Maximum length: 2083. |
| `result.data.organizations[].industry` | `string \| null` | Yes | — | — |
| `result.data.organizations[].total_employees` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].matching_people_count` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].matching_team_count` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].matching_job_post_count` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].headquarters_country` | `string \| null` | Yes | — | — |
| `result.data.organizations[].headquarters_state` | `string \| null` | Yes | — | — |
| `result.data.organizations[].domain` | `string \| null` | Yes | — | — |
| `result.data.organizations[].linkedin_organization_url` | `string \| null` | Yes | — | Format: `uri`. Minimum length: 1. Maximum length: 2083. |
| `result.data.organizations[].account_score` | `number \| null` | No | — | — |
| `result.data.organizations[].account_score_fit` | `string \| null` | No | — | — |
| `result.data.organizations[].matching_tags` | `array \| null` | No | — | — |
| `result.data.organizations[].matching_entities` | `array \| null` | No | — | — |
| `result.data.organizations[].matching_entities[].type` | `string` | Yes | — | — |
| `result.data.organizations[].matching_entities[].term` | `string` | Yes | — | — |
| `result.data.organizations[].matching_entities[].job_post_count` | `integer` | Yes | — | — |
| `result.data.organizations[].matching_entities[].people_count` | `integer` | Yes | — | — |
| `result.data.organizations[].matching_entities[].team_count` | `integer` | Yes | — | — |
| `result.data.organizations[].matching_entities[].job_post_used_count` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].matching_entities[].team_count_used` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].account_status` | `"is_customer" \| "is_in_crm" \| "is_not_in_crm"` | No | — | Allowed: `is_customer`, `is_in_crm`, `is_not_in_crm`. |
| `result.data.organizations[].funding_last_round_type` | `string \| null` | Yes | — | — |
| `result.data.organizations[].funding_last_round_date` | `string \| null` | Yes | — | Format: `date`. |
| `result.data.organizations[].funding_total_raised` | `integer \| null` | Yes | — | — |
| `result.data.organizations[].funding_sources` | `array \| null` | Yes | — | — |
| `result.data.source_data_url` | `string` | Yes | — | Format: `uri`. Minimum length: 1. Maximum length: 2083. |
| `result.data.total` | `integer` | Yes | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "organizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "parent_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2083,
                  "format": "uri"
                },
                "industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "total_employees": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "matching_people_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "matching_team_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "matching_job_post_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "headquarters_country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "headquarters_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "linkedin_organization_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "minLength": 1,
                  "maxLength": 2083,
                  "format": "uri"
                },
                "account_score": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "account_score_fit": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "matching_tags": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "string"
                  }
                },
                "matching_entities": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "term": {
                        "type": "string"
                      },
                      "job_post_count": {
                        "type": "integer"
                      },
                      "people_count": {
                        "type": "integer"
                      },
                      "team_count": {
                        "type": "integer"
                      },
                      "job_post_used_count": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "team_count_used": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "type",
                      "term",
                      "job_post_count",
                      "people_count",
                      "team_count",
                      "job_post_used_count",
                      "team_count_used"
                    ],
                    "additionalProperties": false
                  }
                },
                "account_status": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "enum": [
                    "is_customer",
                    "is_in_crm",
                    "is_not_in_crm"
                  ]
                },
                "funding_last_round_type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "funding_last_round_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date"
                },
                "funding_total_raised": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "funding_sources": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "id",
                "parent_id",
                "name",
                "url",
                "industry",
                "total_employees",
                "matching_people_count",
                "matching_team_count",
                "matching_job_post_count",
                "headquarters_country",
                "headquarters_state",
                "domain",
                "linkedin_organization_url",
                "funding_last_round_type",
                "funding_last_round_date",
                "funding_total_raised",
                "funding_sources"
              ],
              "additionalProperties": false
            }
          },
          "source_data_url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2083,
            "format": "uri"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "organizations",
          "source_data_url",
          "total"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Sumble provider guide](https://deepline.com/docs/providers/sumble/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.