> For the complete documentation index, see [llms.txt](https://developer.fusionbase.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.fusionbase.com/docs/api/organizations.md).

# Organizations

The Organizations API gives you structured access to companies registered in Germany — corporations (GmbH, AG, SE, …), partnerships (OHG, KG, GbR, …), cooperatives (eG), associations (e.V.) and public-law entities. Every organization is identified by a stable `fb_entity_id` that you use to fetch its base record and any of its data slices.

This section is organised as three endpoints, each with its own subpage:

| Endpoint               | What it returns                                                                                                                                         | When to use it                                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Organization Search    | Ranked list of organizations matching a free-text query and optional structured filters (status, location, registration, industry, size, financials).   | Find a company. Build name pickers, market-mapping tools, or filter-driven lists.                    |
| Organization Entity    | The canonical profile of one organization — name, address, legal registration, classifications, contact details, status.                                | Fetch the base record once you know the `fb_entity_id`.                                              |
| Organization Relations | Typed data slices about one organization: management, shareholders, balance sheets, P\&L, financial reports, news, network, nearby companies, and more. | Drill into specific data for a known organization. Each slice is a separate relation you call by ID. |

***

### The three-step flow

Almost every integration follows the same pattern:

```
1. Search        →  resolve fb_entity_id
2. Entity        →  load the base profile
3. Relation(s)   →  fan out to the data slices you need
```

`fb_entity_id` is the linking key. It's stable across data refreshes — persist it instead of name + address combinations.

#### Minimal end-to-end example

```bash
# 1. Find the company
curl -G 'https://api.fusionbase.com/api/v2/search/entities/organization' \
  -H 'X-API-KEY: <YOUR_API_KEY>' \
  --data-urlencode 'q=OroraTech GmbH'
# → results[0].entity.fb_entity_id = "82a68ab9f7151fa0af9bf189c1caa753"

# 2. Load the base record
curl 'https://api.fusionbase.com/api/v2/entities/organization/get/82a68ab9f7151fa0af9bf189c1caa753' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

# 3. Fetch the Management relation (5906082026)
curl -X POST 'https://api.fusionbase.com/api/v2/relation/resolve/5906082026/82a68ab9f7151fa0af9bf189c1caa753' \
  -H 'X-API-KEY: <YOUR_API_KEY>'
```

***

### Authentication

All three endpoints share the same authentication scheme — your Fusionbase API key in the `X-API-KEY` header on every request:

```http
X-API-KEY: <YOUR_API_KEY>
```

See each subpage for the full request format and examples.

***

### Data coverage

The Organizations API draws from Fusionbase's curated mirror of official German registers:

* **Handelsregister** — companies, partnerships, cooperatives and associations registered across all German registry courts (HRA / HRB / GnR / GsR / PR / VR).
* **Bundesanzeiger** — published annual financial statements (Jahresabschluss / Konzernabschluss).
* **Insolvency notices** — official insolvency proceedings from the federal insolvency notices portal.

International coverage and additional sources are added over time. The `source` field on each response tells you which dataset the record came from.

***

### Browse before you build

The fastest way to understand what's available is the [Fusionbase Data Hub catalog](https://app.fusionbase.com/browse-data). The **Unternehmen / Company** category lists every relation with a live API Playground that runs against real example entities — you can see the exact response schema and parameter shape before writing a line of code.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.fusionbase.com/docs/api/organizations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.