URL: /code/data/organizations · Id: `page:/code/data/organizations`

# Organizations

> An Organization is “an outside party as one startup knows it, keyed by its domain”: count the ones that fit, then list them best first.

An [Organization](https://startupbuilder.dev/business/nouns/organization) is “an outside party as one [startup](https://startupbuilder.dev/business/nouns/startup) knows it, keyed by its domain”: count the ones that fit, then list them best first.

- **Noun:** [Organization](https://startupbuilder.dev/business/nouns/organization)
- **Calls:** 4
- **Emits:** `Organization.counted`, `Organization.found`, `Organization.enriched`, `Organization.resolved`

A Data Verb reads the market and returns a reading. A Software Verb changes your records and emits an Event. Every call here is a Data Verb: it reads, and it changes a record only where its Effects say so.

## Properties
| Field | Type | What `null` means |
| --- | --- | --- |
| `count` | `number`, in companies | Never null: a count of 0 means no company matched. |
| `ignored` | `string[]` | Never null: empty when every filter you sent was applied. |
| `observedAt` | `string`, in ISO 8601 | Never null. |
| `method` | `Observed['method']` | Never null. Counts read `'estimated'`: they come from a company index, not a live read of each site. |
| `organizations` | `Organization[]` | Never null: empty when nothing matched, at $0. |
| `organizations[].hostname` | [`Hostname`](/code/data/types#hostname) | Never null: a company is keyed by its domain. |
| `organizations[].name` | `string` | Never null. |
| `organizations[].industry` | `string \| null` | Unknown: no source classifies it. |
| `organizations[].headcount` | `number \| null`, in people | Unknown, never zero. |
| `organizations[].country` | `string \| null`, in ISO 3166-1 | Unknown. |
| `organizations[].region` | `string \| null`, in ISO 3166-2 | Unknown. |
| `organizations[].fit` | `{ score: number; verdict: 'strong' \| 'possible' \| 'no' \| 'unknown' }`, in score 0 to 1 | Absent without `question`. `unknown` means no quote on the site could be confirmed word for word. |
| `organizations[].evidence` | `{ quote: string; url: string }[]` | Absent without `question`. Every quote appears verbatim on the page it cites. |
| `organizations[].similarity` | `{ score: number; reason: string }` | Absent without `similarTo`. |
| `organizations[].event` | `{ kind: string; date: string; summary: string; url: string }` | Absent without `where.event`. |
| `organizations[].place` | `{ address: string; phone: string \| null; rating: number \| null; reviews: number \| null }` | Absent without `where.near`. |
| `organizations[]` | [`Observed`](/code/data/types#observed) | Each row also carries `observedAt` and `method`, and `venue` and `locale` where the reading has them. |
| `after` | [`Cursor`](/code/data/types#cursor) | The last page: there are no more rows. |
| `total` | `number \| null`, in companies | The source does not report a total. |
| `cost` | [`Cost`](/code/data/types#cost), in USD | Never null. In try mode `usd` is 0 and `maxUsd` is what the call would have cost. |
| `organizations[].description` | `string \| null` | Unknown. |
| `organizations[].headcountTrend` | `{ months: 6 \| 12 \| 24; change: number }[]`, in share, 0.21 is +21% | Absent without `headcount` in `fields`. |
| `organizations[].founded` | `number \| null`, in year | Unknown. |
| `organizations[].socials` | `{ linkedin?: string; x?: string; facebook?: string }` | Never null: a missing key means no profile was found on that site. |
| `organizations[].technologies` | `{ name: string; category: string; firstSeen: string \| null; evidence: 'page' \| 'job-post' \| 'dns' \| null }[]` | Absent without `technologies`. `firstSeen: null` means seen, date unknown. |
| `organizations[].hiring` | `{ title: string; postedAt: string; url: string; location: string \| null }[]` | Absent without `hiring`; empty means no open role in `since`. |
| `organizations[].events` | `{ kind: string; date: string; summary: string; url: string }[]` | Absent without `events`; empty means nothing dated in `since`. A `funded` event carries the round. |
| `organizations[].filled` | `string[]` | Never null: the fields this call filled, so a miss is visible. |
| `organization` | `Organization \| null` | No company matched the clue: a residential or mobile IP, a free-mail address, or an unknown name. Free. |
| `organization.confidence` | `number`, in score 0 to 1 | Never null when `organization` is set. |
| `matchedOn` | `'ip' \| 'email' \| 'name' \| 'hostname'` | Never null: the clue that matched. |
| `created` | `boolean` | Never null: `true` only when `save` created the Organization. |

## Object
```json
{
  "name": "Harborview Property Management",
  "hostname": "harborview-pm.com",
  "industry": "Real estate",
  "headcount": 34,
  "founded": 2009,
  "country": "US",
  "region": "US-WA",
  "doors": 1100
}
```

## Verbs
| Verb | The question it answers | Price | Success rate |
| --- | --- | --- | --- |
| [`Organization.count`](/code/data/organizations/count) | How many companies match my customer? | Free | 100% of 171,792 calls |
| [`Organization.find`](/code/data/organizations/find) | Which companies fit my customer, best first? | 3.8¢ per 100 rows | 100% of 185,187 calls |
| [`Organization.enrich`](/code/data/organizations/enrich) | What is this company, what does it run, and what happened there lately? | 20¢ per 100 companies | 99.98% of 569,418 calls |
| [`Organization.resolve`](/code/data/organizations/resolve) | Which company is behind this visit, address or name? | Free | 99.97% of 419,320 calls |

## The order you call them in
1. [`Organization.count`](/code/data/organizations/count): How many companies match my customer?
2. [`Organization.find`](/code/data/organizations/find): Which companies fit my customer, best first?
3. [`Organization.enrich`](/code/data/organizations/enrich): What is this company, what does it run, and what happened there lately?
4. [`Organization.resolve`](/code/data/organizations/resolve): Which company is behind this visit, address or name?

## Monitors on this Noun
| Verb | What it watches |
| --- | --- |
| [`Organization.enrich`](/code/data/organizations/enrich) | A saved company raises, hires for a role your product replaces, or adds a product to its site. |
| [`Organization.find`](/code/data/organizations/find) | New companies in your filters that raised or posted a role this week. |

## Works with
- **Workflows:** [Build a verified list](/capabilities/find-customers/build-a-verified-list) · [Pick who to sell to first](/capabilities/find-customers/pick-who-to-sell-to) · [Champion moved](/capabilities/keep-and-grow/champion-moved) · [Buying-trigger feed](/capabilities/find-customers/buying-trigger-feed) · [Lookalikes](/capabilities/find-customers/lookalikes) · [Inbound routing](/capabilities/convert-visitors/inbound-routing) · [List refresh](/capabilities/find-customers/list-refresh) · [Who is visiting](/capabilities/convert-visitors/whos-visiting)
- **Agent tasks:** [Account brief](/capabilities/reach-out/account-brief) · [Answer every inbound](/capabilities/convert-visitors/answer-every-inbound)