# Sumble · Organizations

Find companies, people and contact details with Sumble · Organizations from Alexandria through one Spiral API key. Resolve organizations by id, slug, domain, or name, or search them with a Sumble advanced query. Unmatched inputs and an empty page cost nothing. metrics "all" and exploded technology categories are not accepted. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `sumble/companies/organizations`
- Page: https://spiral.ai/tools/alexandria/sumble/companies/organizations

## Pricing

Up to $0.087295 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `select` (required) | JSON |  | — | attributes lists baseline fields. A matched organization costs 1 Sumble credit. id, slug, name, url, sumble_url, linkedin_url, and account_status do not add another credit. Every other attribute costs 1 Sumble credit per organization. entities lists metric selections. Known attributes: id, slug, name, url, employee_count, industry, jobs_count, teams_count, jobs_count_rollup, jobs_count_no_rollup, teams_count_rollup, teams_count_no_rollup, people_count_rollup, people_count_no_rollup, headquarters_country, sumble_score, sumble_fit, sumble_url, linkedin_url, parent_id, subsidiary_ids, tags, status, status_reason, account_status, funding_total_raised, funding_valuation, funding_last_round_raised, funding_last_round_type, funding_last_round_date, funding_last_round_investors. |
| `limit` | number | 1 to 10 | 10 | Filter mode page size. Omission sends 10, Sumble's default, which is the most a 1-credit row can return under the 100 Firecrawl credit ceiling. |
| `filter` | JSON |  | — | Advanced query, { query }. Mutually exclusive with organizations. |
| `offset` | number | 0 to 10000 | — | Rows to skip. Defaults to 0. |
| `match_source` | one of | any, job_post | — | Filter mode. any matches job posts or employee profiles. job_post matches job posts only. |
| `organizations` | JSON |  | — | Organizations to resolve, each with id, slug, name, or url. Mutually exclusive with filter. Unmatched inputs are free. At most 10, and fewer when paid attributes or metrics are requested. |
| `include_closed` | true or false |  | — | Filter mode only. Include organizations Sumble marks closed. They are excluded by default. |
| `order_by_column` | text |  | — | Filter mode sort. people_concentration and people_count_growth_1y need order_by_job_function. job_post_concentration needs order_by_advanced_query. |
| `order_by_direction` | one of | ASC, DESC | — | ASC or DESC. Filter mode only. |
| `order_by_job_function` | text |  | — | Job function for a people_concentration or people_count_growth_1y sort. |
| `order_by_advanced_query` | text |  | — | Advanced query for a job_post_concentration sort. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "sumble/companies/organizations",
    "input": {
      "select": {},
      "organizations": [
        {}
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=sumble%2Fcompanies%2Forganizations

## Common questions

### Sumble · Organizations

**How much does Sumble · Organizations cost?**

Up to $0.087295 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Sumble · Organizations through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "sumble/companies/organizations"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Sumble · Organizations?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Sumble · Organizations?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

