# Organizations (/docs/facts/organizations)



Organization facts are canonical company and institution records from the knowledge graph. See also [how organizations are modeled](/docs/core-concepts/organizations).

**Endpoints:**

* `POST /facts/organizations/search` — [playground](/docs/api-reference/endpoints/search_organizations_facts_organizations_search_post)
* `POST /facts/organizations/time-series` — [playground](/docs/api-reference/endpoints/organizations_time_series_facts_organizations_time_series_post)

Time series buckets use **founded-on** dates.

## Typical Questions [#typical-questions]

* Which companies are present for this topic?
* Is new company formation accelerating?
* Which organizations have the strongest topic link (`certainty`)?

## Type-specific filters [#type-specific-filters]

On top of the [shared fact fields](/docs/facts):

* `employeesCounts` — size buckets such as `1-10`, `51-100`, `10001+`
* `sortColumn` — `name` (default), `founded_on`, or `certainty`
* `fields` — response field selection (defaults include `id`, `name`, `foundedOn`, `certainty`, `employeesCount`)

## Request Patterns [#request-patterns]

### Search [#search]

```json
{
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "query": "northvolt",
  "certainty": 0.5,
  "employeesCounts": ["51-100", "101-250"],
  "take": 25,
  "sortColumn": "name",
  "sortDirection": "asc"
}
```

### Time series [#time-series]

```json
{
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "resolution": "year",
  "start": "2010-01-01",
  "end": "2024-12-31"
}
```

## Response Notes [#response-notes]

Each organization includes `id`, `name`, `foundedOn`, `certainty`, and `employeesCount` unless you narrow `fields`. Time series returns `labels` and `counts`. Organizations without `foundedOn` are counted in `withoutLabel`.

## Validation Notes [#validation-notes]

* `certainty` greater than `0` requires `topicIds`.